List SIM operations for organization

Pre-release

GET

https://cdn.emnify.net/api/v1/sim/operation

GET

/api/v1/sim/operation

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

1 [
2   {
3     "id": "58f8f8f8-aaaa-bbbb-cccc-111111111111",
4     "action": {
5       "id": 1,
6       "description": "Link by SIM"
7     },
8     "status": {
9       "id": 2,
10       "description": "Completed"
11     },
12     "creation_date": "2025-10-01T09:00:00.000Z",
13     "last_updated_at": "2025-10-01T09:00:01.000Z",
14     "finalization_date": "2025-10-01T09:00:01.000Z",
15     "target": [
16       {
17         "sim": {
18           "id": 7372275
19         },
20         "eid": "89123247065724874780755570224832"
21       },
22       {
23         "sim": {
24           "id": 7372276
25         },
26         "eid": "89123247065724874780755570224933"
27       }
28     ],
29     "total_count": 2,
30     "failed_count": 1,
31     "success_count": 0,
32     "error": [
33       {
34         "eid": "89123247065724874780755570224933",
35         "message": "ES2+ downloadOrder failed: EidInvalid — Invalid"
36       }
37     ]
38   }
39 ]

List all SIM operations for your organization.

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.

qstringOptionalformat: "(id|action|status)\:.+"

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

sortstringOptional

format: "^(?:-?(id|action|status|creation_date|finalization_date))(?:\s*,\s*-?(id|action|status|creation_date|finalization_date))*$"

Sort properties according to a comma separated list from the allowed fields (prefix with `-` for descending): - `id` - `action` - `status` - `creation_date` - `finalization_date`

Response

SIM operation list

idstringformat: "uuid"

Operation ID

actionobject

statusobject

creation_datestringformat: "date-time"

last_updated_atstringformat: "date-time"

productobject

finalization_datestring or nullformat: "date-time"

targetlist of objects

total_countinteger

failed_countinteger

success_countinteger

errorlist of objects

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/sim/operation \
>	-H "Authorization: Bearer <token>" \
>	-d page=1 \
>	-d per_page=25

1	[
2	{
3	"id": "58f8f8f8-aaaa-bbbb-cccc-111111111111",
4	"action": {
5	"id": 1,
6	"description": "Link by SIM"
7	},
8	"status": {
9	"id": 2,
10	"description": "Completed"
11	},
12	"creation_date": "2025-10-01T09:00:00.000Z",
13	"last_updated_at": "2025-10-01T09:00:01.000Z",
14	"finalization_date": "2025-10-01T09:00:01.000Z",
15	"target": [
16	{
17	"sim": {
18	"id": 7372275
19	},
20	"eid": "89123247065724874780755570224832"
21	},
22	{
23	"sim": {
24	"id": 7372276
25	},
26	"eid": "89123247065724874780755570224933"
27	}
28	],
29	"total_count": 2,
30	"failed_count": 1,
31	"success_count": 0,
32	"error": [
33	{
34	"eid": "89123247065724874780755570224933",
35	"message": "ES2+ downloadOrder failed: EidInvalid — Invalid"
36	}
37	]
38	}
39	]