Authentication

API Tokens

The Mothership API uses tokens to authenticate requests. To obtain an API token, log in to the dashboard and reach out to our US-based support team. A member of our developer relations team will be in touch shortly to provide you with access tokens for your organization and assist with onboarding.

🚧

API tokens act as passwords for the Mothership API and should be stored securely.

Authorization Header

To authenticate a request, include your API token as a Bearer token in the request's Authorization header.

curl -X "GET" "https://api.mothership.com/beta/shipments/MTHRSP" -H "Authorization: Bearer {YOUR_API_TOKEN}" -H "Content-Type: application/json"

Unauthenticated requests will fail with a 401 response code.

{
    "code": 401,
    "type": "UNAUTHENTICATED",
    "message": "Your authentication token is invalid"
}