How do I set up my corporate endpoints?

Stephanie Boukhari
2026-03-31T21:40:48Z

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.

Corporate Endpoints

List Corporate Entities

Endpoint: GET /v1/corporates

Description: Retrieves a paginated list of corporate entities.

Query Parameters:

PageSize (integer): Number of records per page (e.g., 10).

Cursor (string): Pagination cursor.

Example Request:

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

Example Response Envelope

{
  "data": [
    { "id": "425d3837-8559-4d51-9afc-8d67380a2fd1", "name": "Centtrip Ltd." },
    { "id": "7a1dba14-6e13-4b77-9b99-16f92e68fb45", "name": "ABC Corp." }
  ],
  "meta": { "totalCount": 25 },
  "links": {
    "prev": "https://api.centtrip.com/eu/v1/corporates?cursor=PREVIOUS_CURSOR",
    "next": "https://api.centtrip.com/eu/v1/corporates?cursor=NEXT_CURSOR"
  }
}

Retrieve Corporate Details

Endpoint: GET /v1/corporates/{id}

Description: Retrieves detailed information for a specific corporate entity.

Path Parameter:

id (string): Corporate entity identifier.

Example Request:

curl -X GET "https://api.centtrip.com/eu/v1/corporates/425d3837-8559-4d51-9afc-8d67380a2fd1" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Example Request Envelope:

{
  "data": {
    "id": "425d3837-8559-4d51-9afc-8d67380a2fd1",
    "name": "Centtrip Ltd.",
    "subscriptionType": "Starter",
    "limitType": "Standard"
  },
  "meta": { "totalCount": "5" }
}

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