Skip to main content
GET
/
customers
/
{id}
/
transactions
Customer transactions
curl --request GET \
  --url https://api.cartevo.co/api/v1/customers/{id}/transactions \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "statusCode": 200,
  "message": "Data retrieved successfully",
  "data": [
    {
      "id": "7d1cdfa3-9904-4a17-bce5-092554170c0e",
      "category": "CARD",
      "type": "FUND",
      "amount": 50,
      "status": "SUCCESS",
      "description": "Card funding: **** **** **** 5407",
      "created_at": "2023-11-07T05:31:56Z",
      "card": {
        "id": "91b3c6d6-111b-44da-9f81-16f019bebe8c",
        "status": "ACTIVE",
        "balance": 0.45,
        "currency": "USD",
        "number": "tkAlsp_eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ2YWx1ZSI6IjUzNjAyNTI0ODM0NjU0MDciLCJpYXQiOjE3NjExNDg5NzR9.7sNid1b1pxmkpseiCR45E8Xj9hdmenZDovBcjVatBF0",
        "masked_pan": "**** **** **** 5407",
        "cvv": "tkAlsp_eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ2YWx1ZSI6Ijg1NyIsImlhdCI6MTc2MTE0ODk3NH0.K7YHl0nzZTsScjUma_G5fyxYZFNnK-2SczstVtdMK1A",
        "expiry_month": 10,
        "expiry_year": 28,
        "is_virtual": true,
        "is_physical": false,
        "created_at": "2023-11-07T05:31:56Z"
      },
      "customer": {
        "id": "4d4dad81-7899-4612-a9f6-133ce56a4507",
        "email": "customer@example.com",
        "first_name": "John",
        "last_name": "Doe"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 15,
    "totalPages": 1
  }
}

​
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

NameRequiredDescription
AuthorizationYesBearer <access_token>

​
Path parameters

NameTypeDescription
idstringCustomer ID (UUID).

​
Query parameters

NameTypeDefaultDescription
pageinteger11-indexed page number.
limitinteger10Items per page (max ~100).

​
Response

​
200 — Success

{
  "success": true,
  "statusCode": 200,
  "message": "12 items retrieved successfully",
  "data": [
    {
      "id": "txn_3f8a9b2c4d6e7f8a9b0c1d2e",
      "category": "CARD",
      "type": "AUTHORIZATION",
      "status": "SUCCESS",
      "amount": 12.5,
      "currency": "USD",
      "description": "Amazon.com - Seattle, US",
      "created_at": "2026-05-09T09:42:11.123Z",
      "card": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "masked_pan": "**** **** **** 1111",
        "brand": "VISA"
      }
    }
  ],
  "meta": {
    "page": 1,
    "limit": 10,
    "total": 12,
    "totalPages": 2
  }
}
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

StatusTrigger
404Customer does not exist or belongs to another company.

​
Code examples

cURL
curl -G https://api.cartevo.co/api/v1/customers/8d4f2a1b-5c3e-4d7f-9a6b-2e1c8f9d0a3b/transactions \
  -H "Authorization: Bearer $TOKEN" \
  --data-urlencode "page=1" \
  --data-urlencode "limit=50"

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