Skip to main content
GET
/
cards
/
{id}
/
transactions
Card transactions
curl --request GET \
  --url https://api.cartevo.co/api/v1/cards/{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 /cards/{id}/transactions returns the full transaction history for one card — fundings, withdrawals, merchant authorizations, settlements, refunds, and any cross-border charges. The response is paginated.

​
When to use it

  • Render a per-card transaction view to the cardholder.
  • Reconcile a card’s activity with merchant statements.
  • Investigate a disputed charge.

​
Prerequisites

  • The card must belong to your company.

​
Request

​
Headers

NameRequiredDescription
AuthorizationYesBearer <access_token>

​
Path parameters

NameTypeDescription
idstringCard ID (UUID).

​
Query parameters

NameTypeDefaultDescription
pageinteger00-indexed page number. (Note: this differs from the rest of the API, which uses 1-indexed pagination.)
limitinteger50Items per page. Max recommended: 100.
fromDatestring—ISO 8601 date or datetime. Includes transactions on/after this instant.
toDatestring—ISO 8601 date or datetime. Includes transactions strictly before this instant.
typestring—Filter by transaction type. See Glossary → Transaction for values.
statusstring—Filter by status. One of PENDING, PROCESSING, SUCCESS, FAILED.
includeRawbooleanfalseIf true, attach the raw upstream-issuer payload to each transaction. For debugging.
syncbooleantrueIf true (default), force-refresh from the upstream issuer. Set false to read from Cartevo’s local cache only.

​
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"
      },
      "customer": {
        "id": "8d4f2a1b-5c3e-4d7f-9a6b-2e1c8f9d0a3b",
        "first_name": "John",
        "last_name": "Doe"
      }
    }
  ],
  "meta": {
    "page": 0,
    "limit": 50,
    "total": 12,
    "totalPages": 1
  }
}
FieldTypeDescription
data[].idstringTransaction ID. Use to fetch full detail or in support tickets.
data[].categorystringAlways "CARD" for this endpoint.
data[].typestringOne of AUTHORIZATION, SETTLEMENT, FUNDING, WITHDRAWAL, TERMINATION, DECLINE, REVERSAL, REFUND, CROSS-BORDER.
data[].statusstringOne of PENDING, PROCESSING, SUCCESS, FAILED.
data[].amountnumberTransaction amount in currency.
data[].descriptionstringHuman-readable description (often merchant + city for AUTHORIZATION / SETTLEMENT).
metaobjectStandard pagination metadata. See API Conventions → Pagination.
Pagination quirk: This endpoint uses page=0 for the first page (0-indexed), unlike the rest of the API. We are aligning this in a future release.

​
Error responses

StatusTrigger
404Card does not exist or belongs to another company.
400Invalid fromDate / toDate format, or invalid type / status value.

​
Code examples

cURL
curl -G https://api.cartevo.co/api/v1/cards/550e8400-e29b-41d4-a716-446655440000/transactions \
  -H "Authorization: Bearer $TOKEN" \
  --data-urlencode "fromDate=2026-04-01" \
  --data-urlencode "toDate=2026-05-01" \
  --data-urlencode "type=AUTHORIZATION" \
  --data-urlencode "limit=100"
Node.js (axios)
const { data } = await axios.get(
  `https://api.cartevo.co/api/v1/cards/${cardId}/transactions`,
  {
    headers: { Authorization: `Bearer ${token}` },
    params: {
      fromDate: "2026-04-01",
      toDate: "2026-05-01",
      type: "AUTHORIZATION",
      limit: 100,
      page: 0,
    },
  }
);

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 card.

​
success
boolean
Example:

true

​
statusCode
integer
Example:

200

​
message
string
Example:

"Data retrieved successfully"

​
data
object[]
​
pagination
object