Where can I find information on API integration error handling?

Stephanie Boukhari
2026-03-31T21:39:01Z

Common HTTP status codes and their meanings:

200: Successful response.

400: Invalid request parameters. Example: A PageSize outside of the allowed range.

401: Unauthorized – authentication is missing or invalid.

403: Forbidden – insufficient permissions.

404: Not Found – the requested resource does not exist.

500: Internal Server Error – an unexpected error occurred on the server.

Error responses are typically formatted according to the Problem Details specification:

{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "detail": "PageSize must be between 1 and 100.",
  "instance": "/us/v1/corporates?pageSize=1000",
  "errors": { "PageSize": [ "PageSize must be between 1 and 100." ] },
  "correlationId": "95b82b33-2f46-43f0-8bd3-0c4ffe06d73d"
}

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