List eUICCs | emnify Documentation

import requests
url = "https://cdn.emnify.net/api/v1/euicc"
querystring = {"page":"1","per_page":"25"}
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

[
  {
    "id": 515026,
    "eid": "59634247065724874780755570224832",
    "created": "2025-08-26T09:31:51.000Z",
    "modified": "2025-09-25T11:56:15.000Z",
    "issuer_org": {
      "id": 2,
      "name": "emnify GmbH"
    },
    "customer_org": {
      "id": 44,
      "name": "emnify Test"
    },
    "supported_profile_type": {
      "id": 5,
      "description": "IoT eUICC Profile"
    },
    "status": {
      "id": 1,
      "description": "Active"
    }
  }
]

List all eUICCs for your organization. Use filter parameters to search for specific eUICCs and sort to order the response list.

Authentication

AuthorizationBearer

An auth_token should be provided to authenticate a session. To obtain an auth_token, see the POST request to /api/v1/authenticate.

Query parameters

pageintegerOptional>=1

per_pageintegerOptional1-1000

qstringOptional

format: "^(?:\s*(id|eid|supported_profile_type|status|eim)\:[^,]+)(?:\s*,\s*(id|eid|supported_profile_type|status|eim)\:[^,]+)*\s*$"

Filter parameter in <field>:<criteria> format. Expects a comma-separated list from the allowed fields:

id
eid
supported_profile_type
status
eim

Filter parameter in `<field>:<criteria>` format. Expects a comma-separated list from the allowed fields: - `id` - `eid` - `supported_profile_type` - `status` - `eim`

sortstringOptional

format: "^(?:-?(id|eid|modified|supported_profile_type|status|eim))(?:\s*,\s*-?(id|eid|modified|supported_profile_type|status|eim))*$"

Sort properties according to a comma separated list from the allowed fields (prefix with - for descending):

id
eid
modified
supported_profile_type
status
eim

Sort properties according to a comma separated list from the allowed fields (prefix with `-` for descending): - `id` - `eid` - `modified` - `supported_profile_type` - `status` - `eim`

Response

List of eUICCs

idinteger or null

eidstring or nullformat: "^[0-9]{32}$"<=32 characters

createdstring or nullformat: "date-time"

modifiedstring or nullformat: "date-time"

issuer_orgobject or null

customer_orgobject or null

supported_profile_typeobject or null

statusobject or null

last_auditedstring or nullformat: "date-time"

eimobject or null

simlist of objects or null

Authentication

Query parameters

Response

Errors