v1

latestOpenAPI 3.1.02026-07-247328324.6 KB

Invoices

List all invoices

get/sellers/{seller_id}/invoices

Path parameters

seller_idstring required

An object id with prefix

Example:user_0123456789ABCDEFGHIJKLMNOPq

An object id with prefix

Query parameters

skipinteger

For pagination, skip a number of results

Example:42

For pagination, skip a number of results

takeinteger

Only take up to a number of results.

Example:42

Only take up to a number of results.

idstring

A cursor (bookmark) used to only return results equal or lower than the given id. More efficient than skip for large result sets.

Example:user_0123456789ABCDEFGHIJKLMNOPq

A cursor (bookmark) used to only return results equal or lower than the given id. More efficient than skip for large result sets.

metadataobject

Metadata filters, use the following format to construct a clause for a metadata search: metadata["<field>"]:<value>

Response

Successful operation

Example response

{
  "data": [
    {
      "buyer_id": "user_0123456789ABCDEFGHIJKLMNOPq",
      "currency": "USD",
      "amount_due": 10000,
      "amount_paid": 10000,
      "amount_remaining": 10000,
      "invoice_date": "2024-01-15",
      "due_date": "2024-01-15",
      "total": 10000,
      "supplier_id": "user_0123456789ABCDEFGHIJKLMNOPq",
      "invoice_pdf": "https://www.acme.com",
      "charges": 10000,
      "discount": 10000,
      "shipping": 10000,
      "tax": 10000,
      "fiscal_invoice_id": "cfdi:550e8400-e29b-41d4-a716-446655440000",
      "metadata": {
        "key": "value"
      },
      "id": "user_0123456789ABCDEFGHIJKLMNOPq",
      "created_at": "2024-01-15T10:30:00Z",
      "created_by": "user_0123456789ABCDEFGHIJKLMNOPq",
      "updated_at": "2024-01-15T10:30:00Z",
      "updated_by": "user_0123456789ABCDEFGHIJKLMNOPq"
    }
  ]
}