Skip to main content
Get subscription invoices
curl --request GET \
  --url https://api.salesbricks.com/api/v2/subscriptions/{subscription_id}/invoices \
  --header 'X-SALESBRICKS-KEY: <api-key>'
{
  "count": 123,
  "next": "http://api.example.org/accounts/?offset=400&limit=100",
  "previous": "http://api.example.org/accounts/?offset=200&limit=100",
  "results": [
    {
      "invoice_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "subscription_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "invoice_number": "<string>",
      "due_at": "2023-11-07T05:31:56Z",
      "bill_at": "2023-11-07T05:31:56Z",
      "issued_at": "2023-11-07T05:31:56Z",
      "status": "<string>",
      "fully_paid_at": "2023-11-07T05:31:56Z",
      "grand_total": 123,
      "remaining_amount": 123,
      "currency": "<string>",
      "is_renewal_estimate": true
    }
  ]
}

Authorizations

​
X-SALESBRICKS-KEY
string
header
required

API key for authentication

Path Parameters

​
subscription_id
string
required

Query Parameters

​
limit
integer

Maximum number of invoices to return (default: 100, max: 1000)

​
offset
integer

Number of records to skip (default: 0)

​
ordering
enum<string>

Order results by field (prefix with '-' for descending order)

Available options:
-amount,
-created_at,
-due_at,
amount,
created_at,
due_at
​
scope
enum<string>

Filter invoices based on status (past, current, all)

Available options:
all,
current,
past

Response

200 - application/json
​
count
integer
required
Example:

123

​
results
object[]
required
​
next
string<uri> | null
Example:

"http://api.example.org/accounts/?offset=400&limit=100"

​
previous
string<uri> | null
Example:

"http://api.example.org/accounts/?offset=200&limit=100"