Skip to Main Content

API Reference

API Reference

The API reference provides all the information needed to integrate with the Bango API. Use the links above to navigate to the information you require.

Base URL for Sandbox

  • https://resale.api.sandbox.bango.com

Base URLs for Production

We have 3 regional instances of our production environment, US, AP, EU. Each route will be onboarded into the most appropriate region geographically. Your onboarding documentation will include details of which base url you should use.

  • https://us.resale.api.bango.com
  • https://ap.resale.api.bango.com
  • https://eu.resale.api.bango.com

Authentication

The Bango API uses Basic Auth to authenticate requests using the standard Authorization header. All API requests must be made over HTTPS. Calls made over HTTP will fail, as will API requests without valid authentication.

Bango will supply you with two sets of credentials:

  • Sandbox credentials
    Our sandbox environment enables you to fully test your 2-way integration with Bango. It is also used to complete end-to-end 3-way testing with partners before going to production.
  • Production credentials
    Use these for your live routes in our production environment. Bango only authorizes these credentials for use after your testing is complete and verified.

Please keep your credentials secure! Do not share your credentials in publicly accessible areas such as GitHub, client-side code etc.

General API Guidance

  • Any field marked with an asterisk in the API schema is mandatory.
  • Any optional field may be omitted in a request/response.
  • The responseMessage values that are shown are examples. There are many other strings that can be returned and these are changed and improved as the API evolves. They are provided to support integration and investigation as human readable information. Please do not use them for any other purpose.