Skip to main content
GET
/
invoices
Retrieve a list of invoices
curl --request GET \
  --url https://panel.sendcloud.sc/api/v3/invoices \
  --header 'Authorization: Basic <encoded-value>'
{
  "data": [
    {
      "id": 5501,
      "reference": "INV-2026-000123",
      "created_at": "2026-05-31T00:00:00Z",
      "due_date": "2026-06-30T00:00:00Z",
      "price_taxable": {
        "value": "1240.5000",
        "currency": "EUR"
      },
      "price_non_taxable": {
        "value": "0.0000",
        "currency": "EUR"
      },
      "tax": {
        "value": "260.5050",
        "currency": "EUR"
      },
      "description": "Shipping charges — May 2026",
      "category": "transactional",
      "issuer": {
        "business_name": "Sendcloud B.V.",
        "address": "Stationsplein 32",
        "postal_code": "5611 AC",
        "city": "Eindhoven",
        "country_name": "Netherlands",
        "vat_id": "NL852587582B01",
        "coc_id": "57500015"
      }
    },
    {
      "id": 5480,
      "reference": "INV-2026-000099",
      "created_at": "2026-05-01T00:00:00Z",
      "due_date": null,
      "price_taxable": {
        "value": "49.0000",
        "currency": "EUR"
      },
      "price_non_taxable": null,
      "tax": {
        "value": "10.2900",
        "currency": "EUR"
      },
      "description": "Subscription — May 2026",
      "category": "subscription",
      "issuer": {
        "business_name": "Sendcloud B.V.",
        "address": "Stationsplein 32",
        "postal_code": "5611 AC",
        "city": "Eindhoven",
        "country_name": "Netherlands",
        "vat_id": "NL852587582B01",
        "coc_id": "57500015"
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Basic Authentication using API key and secrets is currently the main authentication mechanism.

Query Parameters

​
cursor
string

The cursor query string is used as the pivot value to filter results. If no value is provided, the first page of results will be returned. To get this value, you must encode the offset, reverse and position into a base64 string.

There are 3 possible parameters to encode:

  • o: Offset
  • r: Reverse
  • p: Position

For example, r=1&p=300 encoded as a base64 string would be cj0xJnA9MzAw. The query string would then be cursor=cj0xJnA9MzAw.

Example:

"cj0xJnA9MzAw"

​
page_size
integer
default:100

The size of the page to fetch. Defaults to 100, max 500.

Required range: 1 <= x <= 500

Response

OK

Retrieve invoices

​
data
Invoice · object[]
required