API Authentication

API Keys

Distribusion uses API keys to allow access to the platform’s inventory and enable the performance of successful API requests. The API Keys follow alpha-numeric format, such as ZW8FXhnBl53yTkrMvoqLp4Xq7mf9nEBGsxpTWrid, and must be passed as an Api-Key header within each request, as shown in the example below:

curl  'https://api.demo.distribusion.com/retailers/v4/stations' \ 
--header 'Api-Key: ZW8FXhnBl53yTkrMvoqLp4Xq7mf9nEBGsxpTWrid' 

Environments

Distribusion has two external environments, which each require their own API key:

• Production environment: https://api.distribusion.com
• Demo environment: https://api.demo.distribusion.com

Retailer Partner Number

For some of the endpoints you call, besides using the API credentials, you should also include your retailer_partner_number. We often refer to this as RPN. This 6-digit number is always shared alongside your API credentials & must be used in tandem with the same credentials used for the endpoint.