Getting started

To use the emnify REST API, you must authenticate with an authentication token. emnify uses JSON Web Tokens (JWTs) as the authentication token.

Base URL: https://cdn.emnify.net

Make your first API call

Get started in minutes using the interactive API explorer.

1

Get an application token

  1. Log in to the emnify Portal
  2. Navigate to Integrations > Application tokens
  3. Click Add token, generate and copy your token, and store it securely

For more detailed instructions, see Application tokens in the Portal.

2

Authenticate

Click Try it to open the API explorer. Paste your application token and send the request to receive your auth_token.

POST
/api/v1/authenticate
1curl -X POST https://cdn.emnify.net/api/v1/authenticate \
2     -H "Content-Type: application/json" \
3     -d '{
4  "application_token": "5cCI6IkpXVCJ9.."
5}'
Try it

Copy the auth_token to paste into the Authorization header of the next call.

3

Make an authenticated request

Use the auth_token from Step 2 to make authenticated requests. Click Try it to retrieve your endpoints:

GET
/api/v1/endpoint
1curl https://cdn.emnify.net/ \
2     -H "Authorization: Bearer <token>"
Try it

The /api/v1/authenticate endpoint has a rate limit of 100 requests per IP in a 5-minute window. Store your auth_token and reuse it instead of authenticating on every request. For more information, see Rate limits.

Use an SDK

If you prefer to use an SDK instead of direct API calls:

Choose your authentication method

Always use application tokens to authenticate with the emnify REST API when possible. Any APIs that currently require user credentials are being updated to support application tokens.

Application tokens

Recommended for most integrations.


Secure M2M authentication without exposing user credentials. Supports IP restrictions and configurable expiration.

User credentials

Required for cross-Workspace operations.


Use for Workspace switching and SIM transfers between Workspaces. Requires handling MFA if enabled.

Learn more

JWTs

Understand how JSON Web Tokens authenticate API requests via the Authorization header.

Multi-factor authentication

Handle MFA when authenticating with user credentials.