How do I set up my corporate endpoints?

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