Get invoice activity

GET /api/v2/billing/invoice-activity Returns invoice activity for your organization — one summary row per issued invoice, with its status, kind, currency, gross amount, and 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.

The first live producer is the IU fee-invoice store: each issued fee invoice appears once as kind: "fees". Media, standalone usage, and credit-purchase producers are not wired yet, so those reserved kinds do not currently appear. Dark-metered usage (cost absorbed by Scope3) and shadow bills are never served. An empty list means this organization has no issued fee invoice yet.

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 legacy v2 storefront api_call tools, and returns the same rows.

Response

{
  "rows": []
}

An issued fee invoice looks like:

{
  "rows": [
    {
      "status": "open",
      "ref": "FEE-000001",
      "label": "Platform fees — 2026-07",
      "kind": "fees",
      "currency": "USD",
      "amountMinor": 12500,
      "dueAt": "2026-08-31T00:00:00.000Z",
      "invoiceRef": "FEE-000001"
    }
  ]
}

Field	Type	Notes
`status`	string	Fee invoices currently emit `open` or `paid`; `accruing` and `overdue` are reserved for future producers/lifecycle projection
`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	Reserved correlation key for a future activity-derived row
`meta.iuQuantity`	number \| absent	Reserved IU quantity for a future standalone `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

Start building

Core Concepts

Buyer operations

Seller operations

Cross-Cutting Reference

Buyer API reference

Seller API reference

Release Notes

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