Skip to content

Authentication

Apptopia supplies a client ID and secret when your Data API account is set up. Exchange these credentials for a JSON Web Token (JWT), then use that token for data requests.

POST https://integrations.apptopia.com/api/login

Send the following form fields with Content-Type: application/x-www-form-urlencoded:

Field Description
client Your API client ID.
secret Your API secret.

The JSON response has this shape:

{ "token": "YOUR_SESSION_TOKEN" }

The documented default session lifetime is two weeks. Authenticate again when your token expires.

Set the Authorization header to the returned token itself:

Authorization: YOUR_SESSION_TOKEN

The API uses the raw token in this header. Do not add a Bearer prefix.

Sign in below, then send a request to the country-list endpoint. You can also paste an existing token without entering your client ID or secret.

The playground retains the token in page memory. The secret field is cleared after a successful sign-in, and Clear credentials removes the token and any displayed response. Reloading or leaving the page also clears the session.

  • Confirm that you are using Data API credentials supplied by Apptopia.
  • Check for leading or trailing whitespace in the client ID, secret, or token.
  • Use form encoding for /api/login and JSON encoding for search requests.
  • If a data request returns 401, create a new session. If it returns 403, check access to that dataset with your Apptopia contact.