Skip to content

TelliSIM API v3 (1.0.0)

API explanation

API explanation diagram

Download OpenAPI description
openapi.json
openapi.yaml
Overview
Languages
Servers
Production server
https://api.tellisim.com/

Subscriptions

Operations related to subscriptions.

Operations

Plans

Operations related to plans.

Operations

Coverage

Operations related to coverage.

Operations

SIM

Operations related to SIM management.

Operations

Operators

Operations related to operators.

Operations

List operators

Request

Returns the list of operators filtered by optional label and country filters.

Security
ApiKeyAuth
Query
labelstring(Label)

Filter operators by label. Allowed values are Green, Aqua, Blue, Voilet, Red, Grey, Orange.

Enum"Green""Aqua""Blue""Voilet""Red""Grey""Orange"
iso2_codesstring

Comma separated list of ISO 2-letter country codes. For example: iso2_codes=MX,US

curl -i -X GET \
  'https://api.tellisim.com/v3/operators?label=Green&iso2_codes=string&key=YOUR_API_KEY_HERE'

Responses

Successful response containing a list of operators.

Bodyapplication/json
errorbooleanrequired

Indicates if there was an error in the request

Example: false
dataArray of objects(Operator)required

An array of operator objects returned by the request

data[].​operator_idstringrequired

The unique identifier for the operator

Example: "2dea792a-2dea-492c-815d-8fb826be8d49"
data[].​namestringrequired

The name of the operator

Example: "AT&T USA"
data[].​iso2stringrequired

ISO 2-letter country code

Example: "US"
data[].​supported_ratsArray of stringsrequired

List of supported Radio Access Technologies (RATs)

Example: ["4G","5G"]
data[].​mcc_mncArray of stringsrequired

List of MCC-MNC codes associated with the operator

Example: ["310-680","310-410"]
Response
application/json
{
  "error": false,
  "data": [
    { … }
  ]
}

Get operator

Request

Retrieves the details of a specific operator.

Security
ApiKeyAuth
Path
operatorIdstringrequired
curl -i -X GET \
  'https://api.tellisim.com/v3/operators/{operatorId}?key=YOUR_API_KEY_HERE'

Responses

Successful response containing operator details.

Bodyapplication/json
errorbooleanrequired

Indicates whether an error occurred during the request

Example: false
dataobject(Operator)required
data.​operator_idstringrequired

The unique identifier for the operator

Example: "2dea792a-2dea-492c-815d-8fb826be8d49"
data.​namestringrequired

The name of the operator

Example: "AT&T USA"
data.​iso2stringrequired

ISO 2-letter country code

Example: "US"
data.​supported_ratsArray of stringsrequired

List of supported Radio Access Technologies (RATs)

Example: ["4G","5G"]
data.​mcc_mncArray of stringsrequired

List of MCC-MNC codes associated with the operator

Example: ["310-680","310-410"]
Response
application/json
{
  "error": false,
  "data": {
    "operator_id": "2dea792a-2dea-492c-815d-8fb826be8d49",
    "name": "AT&T USA",
    "iso2": "US",
    "supported_rats": [ … ],
    "mcc_mnc": [ … ]
  }
}

Webhook Events

Operations related to webhook events.

Webhooks