Skip to main content
GET
/
v1
/
card-issuer
/
customers
/
{customerId}
/
card-transactions
curl -X GET 'https://crypto-api.yativo.com/api/v1/card-issuer/customers/yativo_card_customer_8f9a.../card-transactions' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

{
  "success": true,
  "data": {
    "customer_id": "yativo_card_customer_8f9a...",
    "currency": "EUR",
    "transactions": [
      {
        "transaction_id": "tx_9d8e7f6a5b4c3d2e",
        "type": "purchase",
        "amount": 12.50,
        "currency": "EUR",
        "status": "settled",
        "merchant": "Starbucks",
        "merchant_category": "5812",
        "merchant_city": "Paris",
        "merchant_country": "FR",
        "authorized_at": "2026-05-12T14:15:00.000Z",
        "settled_at": "2026-05-13T02:00:00.000Z",
        "created_at": "2026-05-12T14:15:00.000Z"
      },
      {
        "transaction_id": "tx_3f4g5h6i7j8k9l0m",
        "type": "purchase",
        "amount": 8.99,
        "currency": "EUR",
        "status": "authorized",
        "merchant": "Netflix",
        "merchant_category": "7922",
        "merchant_city": null,
        "merchant_country": "NL",
        "authorized_at": "2026-05-12T10:00:00.000Z",
        "settled_at": null,
        "created_at": "2026-05-12T10:00:00.000Z"
      }
    ],
    "total": 24,
    "page": 1,
    "limit": 20
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.yativo.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Authorization
string
required
Bearer token: Bearer YOUR_ACCESS_TOKEN
​
customerId
string
required
Customer identifier — accepts yativo_card_id, MongoDB _id, or external_customer_id.
​
page
integer
Page number. Defaults to 1.
​
limit
integer
Results per page. Defaults to 20, max 100.
​
status
string
Filter by transaction status. One of: authorized, settled, declined, reversed, partially_reversed, failed, expired.
curl -X GET 'https://crypto-api.yativo.com/api/v1/card-issuer/customers/yativo_card_customer_8f9a.../card-transactions' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

{
  "success": true,
  "data": {
    "customer_id": "yativo_card_customer_8f9a...",
    "currency": "EUR",
    "transactions": [
      {
        "transaction_id": "tx_9d8e7f6a5b4c3d2e",
        "type": "purchase",
        "amount": 12.50,
        "currency": "EUR",
        "status": "settled",
        "merchant": "Starbucks",
        "merchant_category": "5812",
        "merchant_city": "Paris",
        "merchant_country": "FR",
        "authorized_at": "2026-05-12T14:15:00.000Z",
        "settled_at": "2026-05-13T02:00:00.000Z",
        "created_at": "2026-05-12T14:15:00.000Z"
      },
      {
        "transaction_id": "tx_3f4g5h6i7j8k9l0m",
        "type": "purchase",
        "amount": 8.99,
        "currency": "EUR",
        "status": "authorized",
        "merchant": "Netflix",
        "merchant_category": "7922",
        "merchant_city": null,
        "merchant_country": "NL",
        "authorized_at": "2026-05-12T10:00:00.000Z",
        "settled_at": null,
        "created_at": "2026-05-12T10:00:00.000Z"
      }
    ],
    "total": 24,
    "page": 1,
    "limit": 20
  }
}

​
Response fields

The response includes a top-level currency field showing the customer’s card currency, followed by a paginated transactions array.
FieldDescription
customer_idThe identifier passed in the path
currencyThe customer’s card currency (USD, EUR, GBP)
transactions[].transaction_idUnique identifier for this transaction
transactions[].typeTransaction kind — typically purchase, refund, or withdrawal
transactions[].amountTransaction amount
transactions[].currencyTransaction currency (may differ from card currency for foreign transactions)
transactions[].statusCurrent status (see below)
transactions[].merchantMerchant name
transactions[].merchant_categoryMerchant category code (MCC)
transactions[].merchant_cityMerchant city
transactions[].merchant_countryTwo-letter ISO country code
transactions[].authorized_atWhen the transaction was authorized
transactions[].settled_atWhen the transaction settled (null if still pending)
transactions[].created_atWhen the transaction record was first created

​
Transaction statuses

StatusMeaning
authorizedApproved at point of sale; funds are held pending settlement
settledTransaction has settled and funds have been debited
declinedTransaction was declined
reversedTransaction was fully reversed
partially_reversedTransaction was partially reversed
failedTransaction failed after authorization
expiredAuthorization expired before settlement
To view transactions across all customers at once, use List Card Transactions. Real-time transaction events are also delivered via webhooks.