> ## Documentation Index
> Fetch the complete documentation index at: https://docs.interchange.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get invoice activity

> Invoice activity for your organization — status, kind, currency, amount, and due/paid dates

`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.

<Note>
  This endpoint currently always returns `{ "rows": [] }`. Usage-derived rows
  (`kind: "usage"`) only appear after an [Organization IU Rate
  Card](/v2/buyer/billing/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.
</Note>

## Request

```bash curl theme={null}
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

```json theme={null}
{
  "rows": []
}
```

Once invoice activity exists, each row looks like:

```json theme={null}
{
  "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](/v2/reference/errors) for the full error contract.

## Related

<CardGroup cols={2}>
  <Card title="Get billing info" href="/v2/buyer/billing/tasks/get-billing-info" icon="address-card">
    The payer identity invoices are sent to
  </Card>

  <Card title="Billing overview" href="/v2/buyer/billing/overview" icon="file-invoice-dollar">
    How invoicing and remittance work
  </Card>
</CardGroup>