Getting started

Getting started

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

Base URL: https://smartsim.telecom.li

Make your first API call

Get started in minutes using the interactive API explorer.

1

Get an application token

  1. Log in to the Telecom Liechtenstein Portal
  2. Navigate to Integrations > Application tokens
  3. Click Add token, generate and copy your token, and store it securely
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
curl -X POST https://smartsim.telecom.li/api/v1/authenticate \
     -H "Content-Type: application/json" \
     -d '{
  "application_token": "5cCI6IkpXVCJ9.."
}'
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
curl https://smartsim.telecom.li/api/v1/endpoint \
     -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.

Choose your authentication method

Always use application tokens to authenticate with the SmartSIM 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.