How do I authenticate via the API?

Authentication

The API uses OAuth2 with the password grant type.

Authorization URL: https://auth-dev.centtrip.com/connect/authorize

Token URL: https://auth-dev.centtrip.com/connect/token

Scope: api_public_v1

How to Authenticate

1. Obtain an Access Token: Use your client credentials along with user credentials to request a token. For example, using cURL:

curl -X POST "https://auth-dev.centtrip.com/connect/token" \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "grant_type=password&username=YOUR_USERNAME&password=YOUR_PASSWORD&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&scope=api_public_v1" 

2. Use the Token in API Requests: Include the access token in the Authorization header of your requests:

curl -X GET "https://api.centtrip.com/eu/v1/corporates" \ -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