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'
curl -X GET 'https://crypto-api.yativo.com/api/v1/card-issuer/customers/yativo_card_customer_8f9a.../card-transactions?status=settled' \
-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
}
}
{
"success": false,
"error": "CUSTOMER_NOT_FOUND"
}
{
"success": false,
"error": "NOT_APPROVED",
"message": "Card issuer program not approved"
}
Card Issuer Program
Customer Card Transactions
List card spending transactions for a specific customer
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'
curl -X GET 'https://crypto-api.yativo.com/api/v1/card-issuer/customers/yativo_card_customer_8f9a.../card-transactions?status=settled' \
-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
}
}
{
"success": false,
"error": "CUSTOMER_NOT_FOUND"
}
{
"success": false,
"error": "NOT_APPROVED",
"message": "Card issuer program not approved"
}
string
required
Bearer token:
Bearer YOUR_ACCESS_TOKENstring
required
Customer identifier — accepts
yativo_card_id, MongoDB _id, or external_customer_id.integer
Page number. Defaults to
1.integer
Results per page. Defaults to
20, max 100.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'
curl -X GET 'https://crypto-api.yativo.com/api/v1/card-issuer/customers/yativo_card_customer_8f9a.../card-transactions?status=settled' \
-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
}
}
{
"success": false,
"error": "CUSTOMER_NOT_FOUND"
}
{
"success": false,
"error": "NOT_APPROVED",
"message": "Card issuer program not approved"
}
Response fields
The response includes a top-levelcurrency field showing the customer’s card currency, followed by a paginated transactions array.
| Field | Description |
|---|---|
customer_id | The identifier passed in the path |
currency | The customer’s card currency (USD, EUR, GBP) |
transactions[].transaction_id | Unique identifier for this transaction |
transactions[].type | Transaction kind — typically purchase, refund, or withdrawal |
transactions[].amount | Transaction amount |
transactions[].currency | Transaction currency (may differ from card currency for foreign transactions) |
transactions[].status | Current status (see below) |
transactions[].merchant | Merchant name |
transactions[].merchant_category | Merchant category code (MCC) |
transactions[].merchant_city | Merchant city |
transactions[].merchant_country | Two-letter ISO country code |
transactions[].authorized_at | When the transaction was authorized |
transactions[].settled_at | When the transaction settled (null if still pending) |
transactions[].created_at | When the transaction record was first created |
Transaction statuses
| Status | Meaning |
|---|---|
authorized | Approved at point of sale; funds are held pending settlement |
settled | Transaction has settled and funds have been debited |
declined | Transaction was declined |
reversed | Transaction was fully reversed |
partially_reversed | Transaction was partially reversed |
failed | Transaction failed after authorization |
expired | Authorization expired before settlement |
To view transactions across all customers at once, use List Card Transactions. Real-time transaction events are also delivered via webhooks.
⌘I