Help with Error Response Codes

This guide intends to help you understand the cause if you receive an Error response code when calling an Alto API endpoint.

400 (Bad Request) or 404 (Not Found)

Check the following:

• The endpoint URL being called corresponds to the documentation.
• Any required query parameters are included in the request.

401 (Unauthorized)

Check the following:

• There is an Authorization header in the request.
• A current (unexpired) bearer token is being used in that header.

403 (Forbidden)

Check the following:

• There is an AgencyRef header in the request.
• A correct agency reference is being used in that header.

If you have checked the above and they are correct it may be that current permissions do not allow you access to this endpoint - please email [email protected] with your Integration Name so that the permissions can be adjusted.

409 (Conflict)

Check the following:

• The response will include Location response header(s) for the URI of the duplicate resource(s).