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

# Usage and billing

> Who pays, what stops, and how to see it coming.

Your merchants are **billed to you**. They have no card on file, never see a
price from us, and are never shown an invoice. We meter what they use and bill
you monthly.

## Reading spend

```http theme={null}
GET /api/v1/partner/usage/?from=2026-09-01&to=2026-09-30
```

```json theme={null}
{ "from": "2026-09-01", "to": "2026-09-30",
  "total_credits": 4210, "tenant_count": 38, "billed_tenant_count": 21,
  "partner_ceiling": 100000, "ceiling_remaining": 95790,
  "tenants": [{"external_ref": "merchant_8812", "name": "Moti Creations",
               "credits": 1180, "monthly_credit_cap": 5000}] }
```

Defaults to the current calendar month — the window you are invoiced on.
Tenants are sorted by spend, so the one worth looking at is first.

Poll this. It is the difference between managing your margin and discovering it.

## Two brakes

<Steps>
  <Step title="Per-tenant cap">
    `monthly_credit_cap`, set when you provision and changeable any time. One
    busy merchant cannot spend the others' budget.
  </Step>

  <Step title="Partner ceiling">
    A total across every tenant you own. Set it with us. If it is reached, every
    tenant pauses at once.
  </Step>
</Steps>

Raise a cap with a `PATCH` on the tenant; it takes effect immediately.

## What "stopped" looks like

An assistant over its cap does not error. It replies:

> Thanks for your message. Nobody is available to answer automatically right
> now, but the team will get back to you.

The merchant's customer sees a normal, polite message rather than a broken
widget or a billing notice about a company they have never heard of.

<Note>
  A partner-billed tenant is **never** suspended for an unpaid invoice, because
  the merchant was never sent one. The only things that stop it are the two caps
  above — both of which are yours to raise.
</Note>

## Invoicing

Monthly, in arrears, against your metered total. Invoice documents are produced
by a person today; the numbers behind them are the ones this endpoint returns.