How do I set up my card endpoints?

Stephanie Boukhari
2026-03-31T21:26:57Z

Overview

The API endpoints are organized by resource type. Each endpoint returns a JSON response that is wrapped in an envelope containing a data object, and, when applicable, meta information (such as total count) and links for pagination.

Card Endpoints

List Cards

Endpoint: GET /v1/cards

Description: Retrieves a paginated list of cards with optional filters.

Query Parameters:

EntityId (string): Filter by operating entity.

AccountId (string): Filter by account identifier.

Type (string): Filter by card type (e.g., Plastic, Virtual).

Status (string): Filter by card status.

PageSize (integer)

Cursor (string)

Example Request:

curl -X GET "https://api.centtrip.com/eu/v1/cards?PageSize=10" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Retrieve Card Details

Endpoint: GET /v1/cards/{id}

Description: Retrieves detailed information about a specific card.

Path Parameter:

id (string): Card identifier.

Example Request:

curl -X GET "https://api.centtrip.com/eu/v1/cards/02f37ff5-1af9-4d27-91a8-8de52489dedf/expenses?fromDate=2024-12-01T00:00:00Z&toDate=2024-12-31T23:59:59Z&pageSize=20" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Retrieve Card Expenses

Endpoint: ET /v1/cards/{id}/expenses

Description: Retrieves a list of expenses associated with a specific card.

Path Parameter:

id (string): Card identifier.

Query Parameters:

currencyCode (string)

fromDate (ISO 8601 date-time)

toDate (ISO 8601 date-time)

pageSize (integer)

cursor (string)

Example Request:

curl -X GET "https://api.centtrip.com/eu/v1/cards/02f37ff5-1af9-4d27-91a8-8de52489dedf/expenses/48e830c5-a126-41a0-a260-e5a6e3141f9c/receipts" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Retrieve Receipts for a Specific Card Expense

Endpoint: GET /v1/cards/{cardId}/expenses/{transactionId}/receipts

Description: Retrieves receipts linked to a card expense transaction.

Path Parameters:

cardId (string)

transactionId (string)

Example Request:

curl -X GET "https://api.centtrip.com/eu/v1/cards/02f37ff5-1af9-4d27-91a8-8de52489dedf/expenses/48e830c5-a126-41a0-a260-e5a6e3141f9c/receipts" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Retrieve a Specific Card Expense Receipt

Endpoint: GET /v1/cards/{cardId}/expenses/{transactionId}/receipts/{receiptId}

Description: Retrieves details of a specific receipt attached to a card expense.

Path Parameters:

cardId (string)

transactionId (string)

receiptId (string)

Example Request:

curl -X GET "https://api.centtrip.com/eu/v1/cards/02f37ff5-1af9-4d27-91a8-8de52489dedf/expenses/48e830c5-a126-41a0-a260-e5a6e3141f9c/receipts/1cc8426b-fdb9-4bf1-b495-c5406e273ac0" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Playbook Links

1. Environments & Base URLs

2. Authentication

3. Endpoints:

1. Corporate Endpoints

2. Entity Endpoints

3. Account Endpoints

4. Card Endpoints

4. Response Envelopes

5. Error Handling

6. Best Practice & Tips

7. Example Workflow