API
API documentation
API Reference

Authentication

API uses HTTP header-based authentication.

Required header

  • Authorization: Use HTTP Basic authentication. Set the header to Basic <base64-credentials>, where <base64-credentials> is the Base64 encoding of username:password.

Example

Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==

Optional headers for localization

  • X-Client-Country-Code (optional): Two-letter ISO country code that overrides automatic country detection. Example: X-Client-Country-Code: US.
  • X-Client-IP (optional): Client IP address used by the server to infer country when X-Client-Country-Code is not provided. Example: X-Client-IP: 203.0.113.5.

Behavior

  • If X-Client-Country-Code is present and valid the API will use that country context for pricing, availability and localization.
  • If X-Client-Country-Code is not provided but X-Client-IP is provided, the server will attempt to resolve the IP to a country and use that.
  • If none of the optional headers are present the server will use default country settings based on the authenticated client's configuration.

If you need help with credentials or access, contact support@belugga.com.