Schedule eUICC operations | emnify Documentation

Schedules one or more operations on the specified eUICC. Each array element represents a single operation request. This route returns HTTP 404 error for non-IoT eUICCs.

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.

Path parameters

euicc_idintegerRequired

Request

This endpoint expects a list of objects.

actionobjectRequired

validity_periodintegerOptional1-86400Defaults to 86400

Seconds until expiry

iccid_with_luhnstringOptionalformat: "^89[0-9]{18}$"

Full ICCID including the Luhn check digit

activation_codestringOptional

Activation code

enablebooleanOptional

Flag whether downloaded profile should be enabled

rollbackbooleanOptional

Flag whether rollback mechanism should be triggered

Response headers

Linkstring

Comma-separated list of created operation resource URLs with rel=“item”.

Response

Created, operations scheduled

idstringformat: "uuid"

actionobject

statusobject

creation_datestringformat: "date-time"

last_updated_atstringformat: "date-time"

userobject

expiry_datestringformat: "date-time"

finalization_datestringformat: "date-time"

errorobject

iccid_with_luhnstringformat: "^89[0-9]{18}$"

Full ICCID including the Luhn check digit

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

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

This endpoint expects a list of objects.

Seconds until expiry

Full ICCID including the Luhn check digit

Flag whether downloaded profile should be enabled

Flag whether rollback mechanism should be triggered

Comma-separated list of created operation resource URLs with rel=“item”.

Created, operations scheduled

Full ICCID including the Luhn check digit

$	curl -X POST https://cdn.emnify.net/api/v1/euicc/123456/operation \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '[
>	{
>	"action": {
>	"id": 1
>	},
>	"validity_period": 600
>	}
>	]'

1	[
2	{
3	"id": "11111111-2222-3333-4444-555555555555",
4	"action": {
5	"id": 1,
6	"description": "Audit eUICC"
7	},
8	"status": {
9	"id": 1,
10	"description": "Scheduled"
11	},
12	"creation_date": "2025-09-25T12:05:00.000Z",
13	"last_updated_at": "2025-09-25T12:05:00.000Z",
14	"user": {
15	"id": 123456,
16	"name": "John Doe"
17	}
18	}
19	]

$	curl -X POST https://cdn.emnify.net/api/v1/euicc/123456/operation \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '[
>	{
>	"action": {
>	"id": 1
>	},
>	"validity_period": 600
>	}
>	]'

1	[
2	{
3	"id": "11111111-2222-3333-4444-555555555555",
4	"action": {
5	"id": 1,
6	"description": "Audit eUICC"
7	},
8	"status": {
9	"id": 1,
10	"description": "Scheduled"
11	},
12	"creation_date": "2025-09-25T12:05:00.000Z",
13	"last_updated_at": "2025-09-25T12:05:00.000Z",
14	"user": {
15	"id": 123456,
16	"name": "John Doe"
17	}
18	}
19	]