Skip to main content
GET
List invoices

What this endpoint does

Lists invoices issued to the current tenant account.

When to use it

Use it to reconcile billing periods, platform fees, developer-fee credits, and payment status.

Before you call

Authenticate with an API key that can read fees — a scoped key must include fees:read (fees:write implies it); this family also covers revenue and invoices.

Money and balance effect

This is a read-only request. It does not reserve, debit, credit, or settle money.

States and completion

Only issued and settled invoices appear here — issued means awaiting settlement; settled is final. The schema’s draft and void values are internal states that are never returned on this endpoint. Open the invoice for its line-item detail.

Safe retries

GET requests are read-only and may be retried with normal exponential backoff. Do not send an Idempotency-Key. Read Revenue and invoices for the complete workflow.

Authorizations

Authorization
string
header
required

Send the same Wayex API key as Authorization: Bearer <key>.

Query Parameters

status
enum<string>
Available options:
issued,
settled
cursor
string
limit
number
Example:

25

Response

200 - application/json

A cursor-paginated page of your invoices.

data
object[]
required

The page of results, newest first.

hasMore
boolean
required

Whether a further page exists after this one.

nextCursor
string | null
required

Opaque cursor to pass as cursor to fetch the next page, or null at the end.