List eUICCs

Pre-release

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

1 [
2   {
3     "id": 123456,
4     "eid": "89634247065724874780755570224832",
5     "created": "2025-08-26T09:31:51.000Z",
6     "profile": [
7       {
8         "iccid_with_luhn": "89883030000123456789",
9         "status": {
10           "id": 1,
11           "description": "Available"
12         },
13         "customer_org": {
14           "id": 44,
15           "name": "emnify Test"
16         },
17         "name": "emnify IoT eSIM profile",
18         "operator": {
19           "id": 851,
20           "name": "emnify"
21         },
22         "preloaded": true,
23         "fallback_allowed": true,
24         "fallback_attribute": true,
25         "profile_type": {
26           "id": 5,
27           "description": "IoT eUICC Profile"
28         },
29         "endpoint": {
30           "id": 789123,
31           "name": "My device"
32         }
33       }
34     ],
35     "issuer_org": {
36       "id": 2,
37       "name": "emnify GmbH"
38     },
39     "customer_org": {
40       "id": 44,
41       "name": "emnify Test"
42     },
43     "supported_profile_type": {
44       "id": 5,
45       "description": "IoT eUICC Profile"
46     },
47     "status": {
48       "id": 1,
49       "description": "Active"
50     },
51     "last_audited": "2025-09-25T11:56:15.000Z",
52     "last_polled": "2025-09-25T11:56:15.000Z",
53     "last_synced": "2025-09-25T11:56:15.000Z",
54     "eim": {
55       "id": 1,
56       "description": "TBD"
57     }
58   }
59 ]

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_orgobject

customer_orgobject

supported_profile_typeobject

statusobject

last_auditedstring or nullformat: "date-time"

last_polledstring or nullformat: "date-time"

last_syncedstring or nullformat: "date-time"

eimobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

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

1	[
2	{
3	"id": 123456,
4	"eid": "89634247065724874780755570224832",
5	"created": "2025-08-26T09:31:51.000Z",
6	"profile": [
7	{
8	"iccid_with_luhn": "89883030000123456789",
9	"status": {
10	"id": 1,
11	"description": "Available"
12	},
13	"customer_org": {
14	"id": 44,
15	"name": "emnify Test"
16	},
17	"name": "emnify IoT eSIM profile",
18	"operator": {
19	"id": 851,
20	"name": "emnify"
21	},
22	"preloaded": true,
23	"fallback_allowed": true,
24	"fallback_attribute": true,
25	"profile_type": {
26	"id": 5,
27	"description": "IoT eUICC Profile"
28	},
29	"endpoint": {
30	"id": 789123,
31	"name": "My device"
32	}
33	}
34	],
35	"issuer_org": {
36	"id": 2,
37	"name": "emnify GmbH"
38	},
39	"customer_org": {
40	"id": 44,
41	"name": "emnify Test"
42	},
43	"supported_profile_type": {
44	"id": 5,
45	"description": "IoT eUICC Profile"
46	},
47	"status": {
48	"id": 1,
49	"description": "Active"
50	},
51	"last_audited": "2025-09-25T11:56:15.000Z",
52	"last_polled": "2025-09-25T11:56:15.000Z",
53	"last_synced": "2025-09-25T11:56:15.000Z",
54	"eim": {
55	"id": 1,
56	"description": "TBD"
57	}
58	}
59	]