Retrieve invoices for a subscription.

-H "x-api-key: your_secret_key"

GET {{host}}/v1/subscriptions/{id}/invoices?page=1&limit=20&order=DESC

Path Parameters

Field	Data Type	Required	Description
id	string	Yes	Subscription ID or code.

Query Parameters

Field	Data Type	Required	Description
page	integer	No	Page to retrieve. Defaults to `1`.
limit	integer	No	Records per page. Maximum is `100`.
order	string	No	`ASC` or `DESC`.

{
  "status": true,
  "message": "Success",
  "code": 200,
  "data": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "pageCount": 1,
    "hasPreviousPage": false,
    "hasNextPage": false,
    "data": [
      {
        "id": "INV_abc123",
        "status": "PENDING",
        "amount": 5000,
        "currency": "NGN",
        "dueDate": "2026-06-20T10:15:00.000Z"
      }
    ]
  }
}

Subscription Statuses

Subscriptions may be PENDING, ACTIVE, PAST_DUE, NON_RENEWING, COMPLETED, or CANCELLED.