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
}

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