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"