Centtrip Logo
API docs by Redocly

Centtrip API

Download OpenAPI specification:

Public API endpoints providing access to account and card-related operations with enhanced documentation and examples.

Corporate

A ‘corporate’ is a company within Centtrip. A corporate will contain one or more ‘operational entities’ - these are the entities that contain the accounts and cards.

Retrieve list of corporate entities

Fetches a paginated list of corporate entities.

query Parameters
PageSize
integer <int32>
Example: PageSize=10

Number of records per page

Cursor
string
Example: Cursor=8de298de-6ba6-44c7-b00f-529672f2f522

Cursor for pagination

Responses

Response samples

Content type
application/json
{}

Retrieve corporate details

Fetches details for a specific corporate entity by its unique identifier.

path Parameters
id
required
string
Example: 425d3837-8559-4d51-9afc-8d67380a2fd1

Corporate entity identifier

Responses

Response samples

Content type
application/json
{
  • "data": {
    • "id": "425d3837-8559-4d51-9afc-8d67380a2fd1",
    • "name": "Centtrip Ltd.",
    • "subscriptionType": "Smarter",
    • "limitType": "Standard"
    },
  • "meta": {
    • "totalCount": "5"
    }
}

Entity

An ‘entity’ is an operational entity within a corporate. Entities contain two types of account data:

  • One ‘account’ - which contains details of transactions in and out of the account
  • One or more ‘cards’ - which are pre-pay cards with their own balances, which contain details of transactions in and out of the cards

Retrieve list of operating entities

Retrieves a list of operating entities with optional filters for corporate entity association.

query Parameters
CorporateId
string

Filter operating entities by corporate entity identifier

PageSize
integer <int32>
Example: PageSize=10

Number of results per page

Cursor
string
Example: Cursor=8de298de-6ba6-44c7-b00f-529672f2f522

Pagination cursor for retrieving the next or previous page

Responses

Response samples

Content type
application/json
{}

Retrieve operating entity details

Fetches details of a specific operating entity by its identifier.

path Parameters
id
required
string

Unique identifier for the operating entity

Responses

Response samples

Content type
application/json
{
  • "id": "60c6de90-739e-4817-931c-fba5237f9903",
  • "name": "Expenses",
  • "corporateId": "425d3837-8559-4d51-9afc-8d67380a2fd1"
}

Account

Retrieve list of accounts

Retrieves a paginated list of accounts, with optional filters for operating entity identifier, type, and status.

query Parameters
EntityId
string
Example: EntityId=60c6de90-739e-4817-931c-fba5237f9903

Filter accounts by the associated operating entity identifier

Type
string
Example: Type=Operating

Filter accounts by type (e.g., Operating, Card)

Status
string
Example: Status=Active

Filter accounts by status (e.g., Active, Closed)

PageSize
integer <int32>
Example: PageSize=10

Number of records to retrieve per page

Cursor
string
Example: Cursor=8de298de-6ba6-44c7-b00f-529672f2f522

Pagination cursor for retrieving the next or previous page of results

Responses

Response samples

Content type
application/json
{}

Retrieve account details

Fetches detailed information for a specified account based on the provided identifier.

path Parameters
id
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

Unique identifier of the account to be retrieved.

Responses

Response samples

Content type
application/json
{
  • "data": {
    • "id": "01796289-e658-4810-95fd-32f0759e08ab",
    • "name": "Expenses",
    • "type": "Operating",
    • "status": "Active",
    • "reference": "ABCD1234",
    • "baseCurrencyCode": "EUR",
    • "currencyCodes": [
      ],
    • "entityId": "60c6de90-739e-4817-931c-fba5237f9903"
    }
}

Retrieve account balances

Fetches the balance details for a specified account, including available and pending amounts.

path Parameters
id
required
string
Example: 123e4567-e89b-12d3-a456-426614174000

Unique identifier of the account to retrieve balances for.

Responses

Response samples

Content type
application/json
{
  • "data": [
    • {
      }
    ]
}

Retrieve account statements

Fetch a list of statements for a specified account within a given date range. This provides a detailed record of account activities, including transactions, fees, and adjustments.

path Parameters
id
required
string
Example: 12345678

Unique identifier of the account for which statements are requested

query Parameters
currencyCode
required
string <string>
Example: currencyCode=EUR

Currency code (ISO 4217 alphabetic code) for filtering statements

fromDate
required
string <date-time>
Example: fromDate=2024-12-01

Start date (inclusive) for filtering statements (ISO 8601 format)

toDate
required
string <date-time>
Example: toDate=2025-01-01

End date (exclusive) for filtering statements (ISO 8601 format)

pageSize
integer <int32>
Default: 10
Example: pageSize=20

The number of items to return per page for pagination

cursor
string
Example: cursor=8de298de-6ba6-44c7-b00f-529672f2f522

Pagination cursor for retrieving the next or previous page

Responses

Response samples

Content type
application/json
{}

Retrieve account expenses

Get a paginated list of expenses associated with a specific account. Expenses may include payments, purchases, and other financial transactions.

path Parameters
id
required
string
Example: 01796289-e658-4810-95fd-32f0759e08ab

Unique identifier of the account

query Parameters
currencyCode
string
Example: currencyCode=USD

Currency code (ISO 4217 alphabetic code) for filtering expenses

fromDate
string <date-time>
Example: fromDate=2024-12-01

Start date (inclusive) for filtering expenses (ISO 8601 format)

toDate
string <date-time>
Example: toDate=2025-01-01

End date (exclusive) for filtering expenses (ISO 8601 format)

pageSize
integer <int32>
Example: pageSize=10

Number of records to return per page

cursor
string
Example: cursor=8de298de-6ba6-44c7-b00f-529672f2f522

Pagination cursor for navigating through pages

Responses

Response samples

Content type
application/json
{
  • "data": [
    • {
      }
    ],
  • "meta": {
    • "totalCount": 12
    },
  • "links": {}
}

Retrieve receipts for a specific account expense

Get a list of receipts linked to a specific transaction for an account. This endpoint helps to retrieve detailed expense documentation.

path Parameters
accountId
required
string
Example: 01796289-e658-4810-95fd-32f0759e08ab

Unique identifier of the account

transactionId
required
string
Example: a0348076-bdfa-4b00-8687-497d3296fabb

Unique identifier of the transaction

Responses

Response samples

Content type
application/json
{}

Retrieve a specific expense receipt

Fetch details of a specific receipt for a given expense transaction linked to an account. This provides visibility into uploaded receipts for reconciliation purposes.

path Parameters
accountId
required
string
Example: 12345678

Unique identifier of the account

transactionId
required
string
Example: txn-987654

Unique identifier of the transaction

receiptId
required
string
Example: 1cc8426b-fdb9-4bf1-b495-c5406e273ac0

Unique identifier of the receipt

Responses

Card

Retrieve a list of cards

Fetches a paginated list of cards based on optional query parameters such as account identifier, type, and status.

query Parameters
EntityId
string

Filter by operating entity identifier

AccountId
string

Filter by account identifier

Type
string
Example: Type=Plastic

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

Status
string

Filter by card status (e.g., Active, Inactive)

PageSize
integer <int32>
Example: PageSize=10

Number of records per page

Cursor
string
Example: Cursor=8de298de-6ba6-44c7-b00f-529672f2f522

Pagination cursor to retrieve the next or previous set of results

Responses

Response samples

Content type
application/json
{
  • "data": [
    • {
      },
    • {
      }
    ],
  • "meta": {
    • "totalCount": 12
    },
  • "links": {}
}

Retrieve card details

Fetches detailed information about a specific card using its unique identifier.

path Parameters
id
required
string
Example: 02f37ff5-1af9-4d27-91a8-8de52489dedf

Unique identifier of the card

Responses

Response samples

Content type
application/json
{
  • "data": {
    • "id": "02f37ff5-1af9-4d27-91a8-8de52489dedf",
    • "name": "Captain",
    • "cardholderName": "John Smith",
    • "type": "Physical",
    • "status": "Inactive",
    • "cardNumber": "555544******1511",
    • "expiryDate": "2025-01-23",
    • "currencyCodes": [
      ],
    • "accountId": "01796289-e658-4810-95fd-32f0759e08ab",
    • "entityId": "60c6de90-739e-4817-931c-fba5237f9903"
    }
}

Retrieve a list of card expenses

Fetches a paginated list of expenses related to the specified card. Filters can be applied to narrow down results based on currency, date range, and pagination options.

path Parameters
id
required
string

Identifier of the card

query Parameters
currencyCode
string
Example: currencyCode=USD

Currency code (ISO 4217 alphabetic code) for filtering expenses

fromDate
string <date-time>
Example: fromDate=2024-12-01

Start date (inclusive) to filter expenses (ISO 8601 format)

toDate
string <date-time>
Example: toDate=2025-01-01

End date (exclusive) to filter expenses (ISO 8601 format)

pageSize
integer <int32>
Example: pageSize=20

Number of records to return per page

cursor
string
Example: cursor=abc123cursor

Cursor for pagination to get the next or previous set of results

Responses

Response samples

Content type
application/json
{
  • "data": [
    • {
      }
    ],
  • "meta": {
    • "totalCount": 12
    },
  • "links": {}
}

Retrieve receipts for a specific card expense

Fetches a list of receipts associated with a given card expense transaction. This endpoint allows for tracking receipts attached to specific transactions.

path Parameters
cardId
required
string

Identifier of the card

transactionId
required
string

Identifier of the transaction

Responses

Response samples

Content type
application/json
{
  • "data": [
    • {
      }
    ],
  • "meta": {
    • "totalCount": 1
    }
}

Retrieve a specific card expense receipt

Fetches details of a specific receipt linked to a card expense, identified by the provided card, transaction, and receipt IDs.

path Parameters
cardId
required
string

Identifier of the card

transactionId
required
string

Identifier of the transaction

receiptId
required
string

Identifier of the receipt

Responses

Payment

Create payment

Creates a payment with a one-time recipient.

header Parameters
Idempotency-Key
required
string <uuid>
Example: 123e4567-e89b-12d3-a456-426614174000

The unique key for a particular request

Request Body schema: application/json

Request to create payment

accountId
required
string

Account identifier

currencyCode
required
string

Currency of payment (ISO 4217 alphabetic code)

amount
required
number <float>

Payment amount

reference
required
string

Payment reference

reason
required
string
Enum: "PaymentOfInvoice" "PaymentToOwnAccount" "IntercompanyTransfer" "Property" "Investment" "Salary" "Expenses" "Redemptions" "Subscriptions" "Other"

Payment reason

required
object (Recipient)

Responses

Request samples

Content type
application/json
{
  • "accountId": "01796289-e658-4810-95fd-32f0759e08ab",
  • "currencyCode": "EUR",
  • "amount": "1500.45",
  • "reference": "Invoice 12345",
  • "reason": "PaymentOfInvoice",
  • "recipient": {
    • "companyName": "ACME Ltd.",
    • "firstName": "John",
    • "lastName": "Smith",
    • "email": "john.smith@example.com",
    • "address": {
      },
    • "bankDetails": {
      }
    }
}

Response samples

Content type
application/json
{
  • "data": {
    • "id": "6c17cca3-111e-47d2-8bba-568d4c0cde4f",
    • "status": "Completed"
    }
}

Retrieve payment details

Fetches detailed information about a specific payment using its unique identifier.

path Parameters
id
required
string
Example: ca92638e-7064-49f2-a70a-cfe5bae22528

Unique identifier of the payment

Responses

Response samples

Content type
application/json
{
  • "data": {
    • "id": "ca92638e-7064-49f2-a70a-cfe5bae22528",
    • "accountId": "123e4567-e89b-12d3-a456-426614174000",
    • "createdAt": "2026-03-26T13:29:29.53176+00:00",
    • "updatedAt": "2026-03-26T13:29:41.149001+00:00",
    • "currencyCode": "GBP",
    • "amount": 1005.49,
    • "feeCurrencyCode": "GBP",
    • "feeAmount": 4.28,
    • "reference": "Invoice ACME-1234",
    • "reason": "PaymentOfInvoice",
    • "recipient": {
      },
    • "deliveryMethod": "FPS",
    • "status": "Completed"
    }
}