Skip to main content
GET
List transactions (filter by order, client, or status)

Authorizations

x-api-key
string
header
required

API key minted in the MarketBox dashboard. Scope is restricted to the projects you select at creation time. Every route needs the key's standard API access (*) except POST /v1/projects/{projectId}/events, which needs events:write; a key without * is refused with 403 CAPABILITY_NOT_GRANTED.

Path Parameters

projectId
string
required

The project (tenant) that owns the resource. Every resource in this API is scoped to a project, and your API key is restricted to the projects it was issued for — a project outside that scope returns 403.

Minimum string length: 1
Example:

"prj_01kv60qgnef2kt3pvqgwmkbzfr"

Query Parameters

orderId
string
Minimum string length: 1
clientId
string
Minimum string length: 1
status
enum<string>
Available options:
PENDING,
SUCCEEDED,
FAILED,
CANCELED
startDate
string<date-time>
endDate
string<date-time>
limit
integer
default:50

Maximum rows to return in data, 1–200. Defaults to 50. Values outside the range return 400. A page can still hold fewer rows than requested, so treat nextCursor: null as the only end-of-results signal and never stop on a page that merely looks short.

Required range: 1 <= x <= 200
Example:

50

cursor
string

Opaque pagination token from a previous response's nextCursor. Treat it as a magic string — never parse or construct one. A cursor is only valid for the same filters that produced it, and nextCursor: null means the last page.

Response

Transactions

data
object[]
required
nextCursor
string | null
required