From token to first request in five minutes

Tell us what you're building and we'll set you up with a SIMSY portal account, a developer SIM or eSIM with starter credit, and access to the API. eSIM activation is a QR code, typically under a minute.

In the SIMSY portal, open API Tokens and create a new token. Copy it once — you won't see it again. Export it as an environment variable on the machine you're testing from.

$ export SIMSY_TOKEN="eyJhbGciOiJI..."   # your JWT from the portal

# Confirm the token is valid
$ curl https://api.s-imsy.com/api/v1/apitokens/verify \
  -H "Authorization: Bearer $SIMSY_TOKEN"

An endpoint is a SIM and the device behind it. The list call returns every endpoint on your account, with identifiers (ICCID, IMSI, MSISDN), grouping, VSlice membership, routing policy, latest country and operator, current IP address, and rolling usage.

$ curl https://api.s-imsy.com/api/v1/endpoints \
  -H "Authorization: Bearer $SIMSY_TOKEN"

# Note an endpoint reference, ICCID, or id to use below.

Most endpoint operations accept an id, ICCID, or your own reference as the path parameter. The status call returns the last-seen timestamp and network status. Location returns the latest country, operator, and access technology. Key-values store device configuration on the network itself, no on-device persistence needed.

# Status: when was it last seen, what's its network state?
$ curl https://api.s-imsy.com/api/v1/endpoints/{id}/status \
  -H "Authorization: Bearer $SIMSY_TOKEN"

# Location: country, operator, RAT, latest update
$ curl https://api.s-imsy.com/api/v1/endpoints/{id}/location \
  -H "Authorization: Bearer $SIMSY_TOKEN"

# Key-values: device configuration held on the network
$ curl https://api.s-imsy.com/api/v1/endpoints/{id}/keyvalues \
  -H "Authorization: Bearer $SIMSY_TOKEN"

The Events resource lets you read past events on the account or a specific endpoint, and wire up event handlers and subscriptions to push events to your services as they happen.

# All recent events on the account
$ curl https://api.s-imsy.com/api/v1/events \
  -H "Authorization: Bearer $SIMSY_TOKEN"

# Events for a single endpoint
$ curl https://api.s-imsy.com/api/v1/endpoints/{id}/events \
  -H "Authorization: Bearer $SIMSY_TOKEN"