Trigger SIM operation | emnify Documentation

curl -X POST https://cdn.emnify.net/api/v1/sim/operation \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "action": {
    "id": 1
  },
  "target": [
    {
      "sim": {
        "id": 7372275
      },
      "eid": "89123247065724874780755570224832"
    }
  ]
}'

{
  "id": "58f8f8f8-aaaa-bbbb-cccc-111111111111",
  "action": {
    "id": 1,
    "description": "Link by SIM"
  },
  "status": {
    "id": 1,
    "description": "Processing"
  },
  "creation_date": "2025-10-01T09:00:00.000Z",
  "last_updated_at": "2025-10-01T09:00:00.000Z",
  "target": [
    {
      "sim": {
        "id": 7372275
      },
      "eid": "89123247065724874780755570224832"
    }
  ],
  "total_count": 1,
  "failed_count": 0,
  "success_count": 0
}

curl -X POST https://cdn.emnify.net/api/v1/sim/operation \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "action": {
    "id": 1
  },
  "target": [
    {
      "sim": {
        "id": 7372275
      },
      "eid": "89123247065724874780755570224832"
    }
  ]
}'

{
  "id": "58f8f8f8-aaaa-bbbb-cccc-111111111111",
  "action": {
    "id": 1,
    "description": "Link by SIM"
  },
  "status": {
    "id": 1,
    "description": "Processing"
  },
  "creation_date": "2025-10-01T09:00:00.000Z",
  "last_updated_at": "2025-10-01T09:00:00.000Z",
  "target": [
    {
      "sim": {
        "id": 7372275
      },
      "eid": "89123247065724874780755570224832"
    }
  ],
  "total_count": 1,
  "failed_count": 0,
  "success_count": 0
}

Trigger a SIM operation.

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.

Request

This endpoint expects an object.

actionobjectRequired

targetlist of objectsRequired

productobjectOptional

Response headers

Linkstring

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

Response

Created, SIM operation scheduled

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 -X POST https://cdn.emnify.net/api/v1/sim/operation \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"action": {
>	"id": 1
>	},
>	"target": [
>	{
>	"sim": {
>	"id": 7372275
>	},
>	"eid": "89123247065724874780755570224832"
>	}
>	]
>	}'

1	{
2	"id": "58f8f8f8-aaaa-bbbb-cccc-111111111111",
3	"action": {
4	"id": 1,
5	"description": "Link by SIM"
6	},
7	"status": {
8	"id": 1,
9	"description": "Processing"
10	},
11	"creation_date": "2025-10-01T09:00:00.000Z",
12	"last_updated_at": "2025-10-01T09:00:00.000Z",
13	"target": [
14	{
15	"sim": {
16	"id": 7372275
17	},
18	"eid": "89123247065724874780755570224832"
19	}
20	],
21	"total_count": 1,
22	"failed_count": 0,
23	"success_count": 0
24	}