Get invoice activity

GET /api/v2/billing/invoice-activity Returns the invoice activity for your organization — one row per invoice line, with its status, what it’s for (media spend, platform fees, metered AI usage, or a credit-line purchase), currency, amount, and the due or paid date. It powers the Invoice activity section at the top of the Invoices tab on the org Billing page. This endpoint is shared: both buyer and seller organizations can read their own invoice activity.

This endpoint currently always returns { "rows": [] }. Usage-derived rows (kind: "usage") only appear after an Organization IU Rate Card is published, accepted, and its activity charging launches. Until then there is nothing billable to show; the activated-social-account planning meter and other dark-metered usage (cost absorbed by Scope3, never billed to a customer) are never projected here. Shadow bills (rated-but-not-yet-billable usage) are never served by this endpoint either. Nothing is fabricated: an empty list means there is no billable activity yet, not that the endpoint is broken.

Request

curl

curl "https://api.interchange.io/api/v2/billing/invoice-activity" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

Parameters

Parameter	Type	Notes
`targetCustomerId`	integer (query, optional)	Read a child account’s invoice activity — parent-to-child only, validated against the organization hierarchy

From an agent (MCP)

The get_invoice_activity operation is available on both the buyer and storefront api_call tools, and returns the same rows.

Response

{
  "rows": []
}

Once invoice activity exists, each row looks like:

{
  "rows": [
    {
      "status": "open",
      "label": "June media spend",
      "kind": "media",
      "currency": "USD",
      "amountMinor": 1250000,
      "dueAt": "2026-07-31T00:00:00.000Z",
      "invoiceRef": "INV-2026-06-0091"
    }
  ]
}

Field	Type	Notes
`status`	string	`open`, `accruing`, `paid`, or `overdue`
`ref`	string \| absent	Short reference/number for this activity row, when assigned
`label`	string	Human-readable description of the activity
`kind`	string	`media`, `fees`, `usage`, or `credit_purchase`
`currency`	string	ISO 4217 currency
`amountMinor`	integer	Amount in minor units (e.g. cents for USD)
`dueAt`	string \| absent	Payment due date (ISO 8601), for a formal invoice
`paidAt`	string \| absent	When the invoice was paid (ISO 8601)
`invoiceRef`	string \| absent	Reference to the underlying invoice document, when one exists
`meta.activityKey`	string \| absent	Internal key correlating this row to its source activity
`meta.iuQuantity`	number \| absent	Inventory-unit quantity backing a `usage` row

Errors

401 UNAUTHORIZED — missing or invalid bearer token.
403 ACCESS_DENIED — targetCustomerId isn’t a child of the requesting organization.

See Errors for the full error contract.

Get billing info

The payer identity invoices are sent to

Billing overview

How invoicing and remittance work

Getting Started

Advertisers

Campaigns

Product Discovery

Webhooks

Creatives

Signals & Brand

Audiences & Inventory

Measurement & Conversions

Reporting & Activity

Planning & Governance

Connections

Account & Billing

Request

Parameters

From an agent (MCP)

Response

Errors

Get billing info

Billing overview

​Request

​Parameters

​From an agent (MCP)

​Response

​Errors

​Related

Get billing info

Billing overview

Request

Parameters

From an agent (MCP)

Response

Errors

Related