Billing

Billing endpoints are read-only and organization scoped.

Authentication & scope

Header: X-API-Key: YOUR_API_KEY
Required scope: billing:read
Use API Reference for interactive Try-it support.

`GET /v1/billing/credit-history`

Returns paginated credit usage history.

curl -X GET "https://api.indigenius.ai/v1/billing/credit-history?page=1&pageSize=10" \
  -H "X-API-Key: YOUR_API_KEY"

const response = await fetch(
  'https://api.indigenius.ai/v1/billing/credit-history?page=1&pageSize=10',
  { headers: { 'X-API-Key': process.env.INDIGENIUS_API_KEY } },
);
console.log(await response.json());

import requests

response = requests.get(
    "https://api.indigenius.ai/v1/billing/credit-history",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"page": 1, "pageSize": 10},
    timeout=30,
)
print(response.status_code)
print(response.json())

`200 OK`

This endpoint has no message — data is the pagination object itself:

{
  "success": true,
  "data": {
    "currentPage": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPrevPage": false,
    "nextPage": null,
    "prevPage": null,
    "record": [
      {
        "id": "665e4a34c65bb95f2f2d72e1",
        "organizationId": "665e4a34c65bb95f2f2d72e0",
        "product": "agent",
        "unit": "audio",
        "subProduct": null,
        "callId": "665e4a34c65bb95f2f2d72c1",
        "textToSpeechId": null,
        "speechToTextId": null,
        "duration": 86,
        "cost": 4.2,
        "updatedAt": "2026-06-02T10:00:00.000Z",
        "createdAt": "2026-06-02T10:00:00.000Z"
      }
    ]
  },
  "meta": {
    "requestId": "f3c9b29a-9f4d-4b71-8b3b-2cb77f4e9cf1",
    "timestamp": "2026-06-02T10:30:45.123Z",
    "version": "v1"
  }
}

Common status codes

200 success
403 missing billing:read
500 server error

`GET /v1/billing/transactions`

Returns paginated transaction history (top-ups, charges, refunds) for the organization.

curl -X GET "https://api.indigenius.ai/v1/billing/transactions?page=1&pageSize=10" \
  -H "X-API-Key: YOUR_API_KEY"

const response = await fetch(
  'https://api.indigenius.ai/v1/billing/transactions?page=1&pageSize=10',
  { headers: { 'X-API-Key': process.env.INDIGENIUS_API_KEY } },
);
console.log(await response.json());

import requests

response = requests.get(
    "https://api.indigenius.ai/v1/billing/transactions",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"page": 1, "pageSize": 10},
    timeout=30,
)
print(response.status_code)
print(response.json())

`200 OK`

This endpoint also has no message — data is the pagination object itself:

{
  "success": true,
  "data": {
    "currentPage": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPrevPage": false,
    "nextPage": null,
    "prevPage": null,
    "record": [
      {
        "id": "665e4a34c65bb95f2f2d72e2",
        "amount": 50,
        "duration": "month",
        "description": "Wallet top-up",
        "currency": "USD",
        "transaction_id": "txn_1001",
        "transaction_ref": "tx_ref_1001",
        "status": 1,
        "statusText": "success",
        "updatedAt": "2026-06-02T10:00:00.000Z",
        "createdAt": "2026-06-02T10:00:00.000Z"
      }
    ]
  },
  "meta": {
    "requestId": "f3c9b29a-9f4d-4b71-8b3b-2cb77f4e9cf1",
    "timestamp": "2026-06-02T10:30:45.123Z",
    "version": "v1"
  }
}

Common status codes

200 success
403 missing billing:read
500 server error

`GET /v1/billing/plan`

Returns every plan on the platform’s pricing page, ordered for display.

curl -X GET "https://api.indigenius.ai/v1/billing/plan" \
  -H "X-API-Key: YOUR_API_KEY"

const response = await fetch('https://api.indigenius.ai/v1/billing/plan', {
  headers: { 'X-API-Key': process.env.INDIGENIUS_API_KEY },
});
console.log(await response.json());

import requests

response = requests.get(
    "https://api.indigenius.ai/v1/billing/plan",
    headers={"X-API-Key": "YOUR_API_KEY"},
    timeout=30,
)
print(response.status_code)
print(response.json())

`200 OK`

{
  "success": true,
  "message": "Billing plans fetched",
  "data": [
    {
      "id": "665e4a34c65bb95f2f2d72f1",
      "type": "Prime",
      "index": 1,
      "better_rates": false,
      "best_value_badge": true
    }
  ],
  "meta": {
    "requestId": "f3c9b29a-9f4d-4b71-8b3b-2cb77f4e9cf1",
    "timestamp": "2026-06-02T10:30:45.123Z",
    "version": "v1"
  }
}

Field	Type	Description
`id`	string	Plan id.
`type`	string	Plan name/tier (e.g. `Prime`, `Cool`, `Flex`, `Free`).
`index`	number	Display order on the pricing page.
`better_rates`	boolean	Marketing flag — this plan gets better per-unit rates.
`best_value_badge`	boolean	Marketing flag — this plan is highlighted as best value.

Common status codes

200 success
403 missing billing:read
500 server error

`GET /v1/billing/currencies`

Returns all currencies supported for billing and top-ups.

curl -X GET "https://api.indigenius.ai/v1/billing/currencies" \
  -H "X-API-Key: YOUR_API_KEY"

const response = await fetch(
  'https://api.indigenius.ai/v1/billing/currencies',
  { headers: { 'X-API-Key': process.env.INDIGENIUS_API_KEY } },
);
console.log(await response.json());

import requests

response = requests.get(
    "https://api.indigenius.ai/v1/billing/currencies",
    headers={"X-API-Key": "YOUR_API_KEY"},
    timeout=30,
)
print(response.status_code)
print(response.json())

`200 OK`

{
  "success": true,
  "message": "currency list fetched",
  "data": [
    {
      "id": "665e4a34c65bb95f2f2d72f2",
      "name": "US Dollar",
      "code": "USD",
      "symbol": "$",
      "createdAt": "2026-01-01T00:00:00.000Z",
      "updatedAt": "2026-01-01T00:00:00.000Z"
    },
    {
      "id": "665e4a34c65bb95f2f2d72f3",
      "name": "Nigerian Naira",
      "code": "NGN",
      "symbol": "₦",
      "createdAt": "2026-01-01T00:00:00.000Z",
      "updatedAt": "2026-01-01T00:00:00.000Z"
    }
  ],
  "meta": {
    "requestId": "f3c9b29a-9f4d-4b71-8b3b-2cb77f4e9cf1",
    "timestamp": "2026-06-02T10:30:45.123Z",
    "version": "v1"
  }
}

Common status codes

200 success
403 missing billing:read
500 server error

Getting Started

Core APIs

Platform APIs

Billing

Billing

Authentication & scope

`GET /v1/billing/credit-history`

`200 OK`

Common status codes

`GET /v1/billing/transactions`

`200 OK`

Common status codes

`GET /v1/billing/plan`

`200 OK`

Common status codes

`GET /v1/billing/currencies`

`200 OK`

Common status codes

​Billing

​Authentication & scope

​GET /v1/billing/credit-history

​200 OK

​Common status codes

​GET /v1/billing/transactions

​200 OK

​Common status codes

​GET /v1/billing/plan

​200 OK

​Common status codes

​GET /v1/billing/currencies

​200 OK

​Common status codes

Billing

Authentication & scope

`GET /v1/billing/credit-history`

`200 OK`

Common status codes

`GET /v1/billing/transactions`

`200 OK`

Common status codes

`GET /v1/billing/plan`

`200 OK`

Common status codes

`GET /v1/billing/currencies`

`200 OK`

Common status codes