API Reference

Requests to Kosmo API must be authenticated otherwise they will fail with Unauthorized 401 error response.

Obtain API Key

📘

Getting your key

To get started, request an api key by sending an email to [email protected] along with your business phone number you want or have attached to your account

The api_key will be used to bypass authentication to Kosmo API.

Usage

To authenticate your requests, you must add the Authorization header with Bearer + your API key as the value.

❗️

Security

Your secret key is extremely sensitive, be sure to safely store it and to never share it with anyone outside your tech team.
If you acknowledge a breach, contact us immediately to deprecate your former key and get a new one.

Here is an example of a request to test your key:

curl --location --request GET 'http://api.kosmo.delivery/users/org/all' \
--header 'Authorization: Bearer {api_key}'

The response should contain your organization team information.