Get Invoices

Retrieve a list of your billing invoices.

GET /api/v1/billing/invoices

Authentication

JWT Bearer Token required via Authorization header.

Query Parameters

Parameter	Type	Default	Description
page	integer	1	Page number
limit	integer	20	Results per page (max 100)

Response

200 OK

{
  "data": [
    {
      "id": "inv_abc123",
      "number": "INV-2026-003",
      "status": "paid",
      "amount": 4900,
      "currency": "usd",
      "periodStart": "2026-03-01T00:00:00Z",
      "periodEnd": "2026-04-01T00:00:00Z",
      "paidAt": "2026-03-01T00:05:00Z",
      "pdfUrl": "https://api.audiospliter.com/invoices/inv_abc123.pdf"
    },
    {
      "id": "inv_def456",
      "number": "INV-2026-002",
      "status": "paid",
      "amount": 4900,
      "currency": "usd",
      "periodStart": "2026-02-01T00:00:00Z",
      "periodEnd": "2026-03-01T00:00:00Z",
      "paidAt": "2026-02-01T00:05:00Z",
      "pdfUrl": "https://api.audiospliter.com/invoices/inv_def456.pdf"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 6,
    "totalPages": 1
  }
}

Code Examples

cURL

curl https://api.audiospliter.com/api/v1/billing/invoices \
  -H "Authorization: Bearer your_jwt_token"

Node.js

const response = await fetch(
  'https://api.audiospliter.com/api/v1/billing/invoices',
  { headers: { 'Authorization': `Bearer ${jwtToken}` } }
);
const { data } = await response.json();
data.forEach(inv => console.log(`${inv.number}: $${inv.amount / 100}`));

Python

import requests

response = requests.get(
    'https://api.audiospliter.com/api/v1/billing/invoices',
    headers={'Authorization': f'Bearer {jwt_token}'},
)
for inv in response.json()['data']:
    print(f"{inv['number']}: ${inv['amount'] / 100}")