How do I set up my card endpoints?
Discover insights on key topics that enhance understanding and offer practical knowledge for everyday applications.
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"