Docs / Reference / Invoices
Invoices

List Invoices

Returns paginated invoices for the authenticated publisher. Filter by status or date range.

GET /pub_api/v3/invoices read:invoices
Query parameters
status
string
 Filter by status: invoice_raised, paid, rejected, cancelled.
start_date
date (YYYY-MM-DD)
 Filter invoices on or after this date.
end_date
date (YYYY-MM-DD)
 Filter invoices on or before this date.
page
integer
 Page number. Default: 1.
per_page
integer
 Results per page, 1–100. Default: 30.
Response fields
FieldTypeDescription
data[].idintegerInvoice ID.
data[].invoice_numberstringUnique invoice number.
data[].invoice_datestringInvoice date (YYYY-MM-DD).
data[].statusstringOne of: invoice_raised, paid, rejected, cancelled.
data[].amountstringBase commission amount.
data[].gross_amountstringCommission plus taxes.
data[].tds_amountstringTax Deducted at Source. Always "0" when billing_from is singapore - Singapore-billed payouts are not subject to Indian TDS.
data[].net_paymentstringFinal payable amount. Gross minus TDS for india billing; equals gross_amount for singapore billing.
data[].billing_fromstringindia or singapore.
data[].auto_generatedbooleanWhether this invoice was auto-generated.
data[].created_atstringInvoice creation timestamp (ISO 8601).
metaobjectPagination.
Request
curl https://developers.cuelinks.com/pub_api/v3/invoices \
  -H "Authorization: Token YOUR_API_KEY" \
  -G \
  -d "status=paid"
200 OK200
{
  "data": [
    {
      "id": 1234,
      "invoice_number": "100420261-567",
      "invoice_date": "2026-04-10",
      "status": "paid",
      "amount": "5000",
      "gross_amount": "5900",
      "tds_amount": "100",
      "net_payment": "5800",
      "billing_from": "india",
      "auto_generated": false,
      "created_at": "2026-04-10T08:00:00Z"
    }
  ],
  "meta": { "page": 1, "per_page": 30, "total": 1, "total_pages": 1, "next_page": null, "prev_page": null }
}
← Previous Unmonetized Traffic