Skip to main content
GET
Customer transactions

Overview

GET /customers/{id}/transactions returns the union of card transactions across every card owned by the specified customer — fundings, withdrawals, merchant authorizations, settlements, refunds, and cross-border charges. The response is paginated. To filter to a single card, use GET /cards/{id}/transactions instead.

When to use it

  • Render a customer’s full activity timeline.
  • Compute a customer’s total spend across all their cards.
  • Audit a customer for unusual activity.

Prerequisites

  • The customer must belong to your company.

Request

Headers

Path parameters

Query parameters

Response

200 — Success

The per-transaction shape matches GET /cards/{id}/transactions — see that page for a full field reference. The only difference is the customer block is not included (you already know which customer you queried).

Error responses

Code examples

cURL

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string<uuid>
required

Query Parameters

page
integer
Example:

1

limit
integer
Example:

20

Response

A list of transactions for the specified customer.

success
boolean
Example:

true

statusCode
integer
Example:

200

message
string
Example:

"Data retrieved successfully"

data
object[]
pagination
object