List eUICCs

GET

https://cdn.emnify.net/api/v1/euicc

GET

/api/v1/euicc

curl -G https://cdn.emnify.net/api/v1/euicc \
     -H "Authorization: Bearer <token>" \
     -d page=1 \
     -d per_page=25

[
  {
    "id": 123456,
    "eid": "89634247065724874780755570224832",
    "created": "2025-08-26T09:31:51.000Z",
    "profile": [
      {
        "iccid_with_luhn": "89883030000123456789",
        "status": {
          "id": 1,
          "description": "Available"
        },
        "customer_org": {
          "id": 44,
          "name": "emnify Test"
        },
        "name": "emnify IoT eSIM profile",
        "operator": {
          "id": 851,
          "name": "emnify"
        },
        "preloaded": true,
        "fallback_allowed": true,
        "fallback_attribute": true,
        "profile_type": {
          "id": 5,
          "description": "IoT eUICC Profile"
        },
        "endpoint": {
          "id": 789123,
          "name": "My device"
        }
      }
    ],
    "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"
    },
    "last_audited": "2025-09-25T11:56:15.000Z",
    "last_polled": "2025-09-25T11:56:15.000Z",
    "last_synced": "2025-09-25T11:56:15.000Z",
    "eim": {
      "id": 1,
      "description": "TBD"
    }
  }
]

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>=1Defaults to 1

Page number (1-based).

per_pageintegerOptional1-1000Defaults to 100

Items per page.

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

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

Response

List of eUICCs

idinteger

eidstringformat: "^89[0-9]{30}$"

createdstringformat: "date-time"

profilelist of objects

issuer_orgobjectOptional

customer_orgobjectOptional

supported_profile_typeobjectOptional

statusobjectOptional

last_auditedstring or nullOptionalformat: "date-time"

last_polledstring or nullOptionalformat: "date-time"

last_syncedstring or nullOptionalformat: "date-time"

eimobjectOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error