List your invoices · Ownrecord docs

Lists the signed-in customer's issued invoices and receipts, newest first, with the amount due and a download link of each PDF (pdfPath; null for a moment after issue, while the PDF is prepared). Open invoices with something due are payable by card (portal.invoices.pay). Drafts aren't listed.

Paginate with limit (default 20) and starting_after. Customer portal only (portal:read).

At a glance

REST: GET /api/v1/portal/me/invoices
MCP tool: portal_invoices_list
Operation ID: portal.invoices.list
Scope: Brand
Permission: portal:read
Risk tier: read
Dry run: Not supported
Idempotency: Not needed (read only)
Modes: Test and live
Pagination: limit (at most 100) and starting_after
Authentication: A customer signed in to the customer portal (API keys can't call it)
Since: M9

Request

Query parameters

Field	Type	Required	Description
`limit`	integer (1 to 100)	No	Page size, 1 to 100 (default 20).
`starting_after`	string	No	The `next_cursor` of the previous page.

Response

200 OK with a JSON object, a page of the list (newest first):

Field	Type	Description
`object`	`"list"`
`data`	array of object
`data[].id`	`inv_…` ID
`data[].object`	`"portal_invoice"`
`data[].number`	string
`data[].kind`	string	`invoice` or `receipt`.
`data[].status`	string	`open`, `paid`, `void`, `uncollectible` or `pending_registration`.
`data[].issueDate`	string
`data[].dueDate`	string or null
`data[].currency`	string
`data[].total`	money
`data[].creditApplied`	money or null
`data[].amountDue`	money
`data[].paidAt`	date-time or null
`data[].payable`	boolean	Open with something due: it can be paid by card in the portal.
`data[].pdfPath`	string or null	The PDF's download link, relative to the app URL (null while it is being prepared).
`has_more`	boolean
`next_cursor`	string or null

Examples

Your latest invoices

HTTP

GET /api/v1/portal/me/invoices
Authorization: Bearer or_test_…

Response (200):

JSON

{
  "object": "list",
  "data": [
    {
      "id": "inv_01m4tx5nj8emwbyf7y9vcf48b3",
      "object": "portal_invoice",
      "number": "GEN-2026-000042",
      "kind": "invoice",
      "status": "open",
      "issueDate": "2026-10-20",
      "dueDate": "2026-11-03",
      "currency": "EUR",
      "total": {
        "amount": "120000000",
        "currency": "EUR"
      },
      "creditApplied": null,
      "amountDue": {
        "amount": "120000000",
        "currency": "EUR"
      },
      "paidAt": null,
      "payable": true,
      "pdfPath": "/api/v1/invoices/inv_01m4tx5nj8emwbyf7y9vcf48b3/pdf?token=eyJ…"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Errors

Code	HTTP status	When	What to do
`validation_failed`	400	A field or pagination value is malformed.	Fix the fields listed in `details.issues` and send the request again.
`livemode_not_allowed`	403	The portal session is in the other mode than the request.	Use test mode, or credentials for the target's mode. Developers need live access granted by an organization owner or admin.
`permission_denied`	403	The caller isn't a customer signed in to this brand's portal (operators and API keys use the customer operations).	Ask an organization owner or admin for a role or scope that allows this action.

It can also return these common errors: api_version_unsupported, authentication_required, api_key_invalid, scope_required, resource_not_found, dry_run_not_supported, rate_limited, internal_error.

At a glance#

Request#

Query parameters#

Response#

Examples#

Your latest invoices#

Errors#