Skip to main content
GET
https://api.voxmind.ai
/
organisations
/
{orgId}
/
invoices
# Get the last 12 invoices
curl -X GET "https://api.voxmind.ai/organisations/42/invoices?sort=created_at:desc&per_page=12" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

{
  "results": [
    {
      "id": 11,
      "org_id": 42,
      "sub_id": 3,
      "invoice_sequence": 3,
      "quotas": {
        "monthly_verifications": 9847,
        "overage_calls": 0
      },
      "file_ref": "4d61d50295d55da651aa534a049fc2f159414b89d8d29a56160a266539acfcfc",
      "created_at": "2025-03-31T23:59:59Z",
      "updated_at": "2025-04-01T00:00:01Z"
    }
  ]
}

​
Overview

Returns a paginated list of all invoices generated for your organisation. Each invoice corresponds to a billing period and includes a file_ref — a reference to the invoice PDF document. Use this endpoint to build an invoice history view in your own billing portal or to programmatically retrieve billing data for accounting systems. Invoices are generated automatically at the end of each billing period and include your base subscription charge plus any overage calls billed at your tier’s overage rate.

​
Path Parameters

​
orgId
string
required
Your organisation’s unique identifier.

​
Query Parameters

​
filter
string
Filter invoices. Example: filter=sub_id=3 for all invoices under a specific subscription.
​
sort
string
Example: sort=created_at:desc for most recent invoices first.
​
per_page
integer
default:"100"
Results per page. Maximum 300.
​
page
integer
default:"1"
Page number.
# Get the last 12 invoices
curl -X GET "https://api.voxmind.ai/organisations/42/invoices?sort=created_at:desc&per_page=12" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

{
  "results": [
    {
      "id": 11,
      "org_id": 42,
      "sub_id": 3,
      "invoice_sequence": 3,
      "quotas": {
        "monthly_verifications": 9847,
        "overage_calls": 0
      },
      "file_ref": "4d61d50295d55da651aa534a049fc2f159414b89d8d29a56160a266539acfcfc",
      "created_at": "2025-03-31T23:59:59Z",
      "updated_at": "2025-04-01T00:00:01Z"
    }
  ]
}