AIin1Portal

List Invoices

GET /api/v1/billing/invoices

Paginated list of your organization's invoices, newest first.

Auth: this endpoint belongs to the console backend API (base URL https://portal.aiin1.ai — note, not api.portal.aiin1.ai). It requires an access_token obtained by logging in with a console account (valid 15 minutes); the sk-nex- API token does not work here. See Billing Reconciliation & Automated Usage Sync for the login flow.

Request parameters

Param In Type Required Description
start query date no Only return invoices whose billing period overlaps [start, end]
end query date no Same as above
page query integer no Page number (default 1)
page_size query integer no Page size (default 20, max 100)

Example

curl "https://portal.aiin1.ai/api/v1/billing/invoices?start=2026-07-01&end=2026-07-31" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Response

An array, one row per invoice:

Field Type Description
id string(uuid) Invoice ID
invoice_no string Invoice number
org_id string(uuid) Organization ID
period_start / period_end date Billing period
total string(decimal) Invoice amount (USD)
status string Invoice status
due_date date Due date
created_at string(datetime) Created at
  • GET /api/v1/billing/invoices/{id} — invoice detail (with line items)
  • GET /api/v1/billing/invoices/{id}/pdf — download invoice PDF
  • GET /api/v1/billing/ledger?page=&page_size= — ledger entries (top-ups / charges / adjustments)