Update the iccPortfolioPackage for a specific SIM

Moves a SIM to a different package, a different portfolio, or both. Send only the fields you want to change.

The package or portfolio you name must already exist on your account.

patch

Autorizações

AuthorizationstringObrigatório

An OAuth 2.0 client credentials access token, sent as Authorization: Bearer <token>.

Request the token from https://eseye-idp-prod.auth.eu-west-1.amazoncognito.com/oauth2/token using the client ID and client secret Eseye supplied. Tokens expire after one hour.

Parâmetros de rota

iccIdstringObrigatório

The ICC ID of the SIM.

Example: 8944500000000000123

Corpo

packageIdstringOpcional

The package to apply to the SIM. Must already exist on your account.

Example: 20888

portfolioIdstringOpcional

The portfolio to move the SIM to. Must already exist on your account.

Example: a628ebc659f7dac01f9fdcbd1116307a

Respostas

200

The updated portfolio and package details.

application/json

The portfolio and package a SIM is assigned to, and its contract dates.

icc2PortfolioPackageIdintegerOpcional

The unique identifier for this portfolio and package assignment.

Example: 8944500000000000000

iccIdstring · máx: 20Opcional

The SIM the assignment belongs to.

Example: 8944500000000000123

portfolioIdstring · máx: 32Opcional

The portfolio the SIM is assigned to. A portfolio is the account that owns the SIM and controls who can access it.

Example: a628ebc659f7dac01f9fdcbd1116307a

portfolioStartDatestring · date-timeOpcional

When the SIM joined the portfolio.

Example: 2026-08-03T00:00:00Z

packageIdintegerOpcional

The package applied to the SIM. A package holds the contract, pricing, and allowance details.

Example: 20888

packageStartDatestring · date-timeOpcional

When the package took effect.

Example: 2026-03-20T00:00:00Z

contractStartDatestring · anulávelOpcional

When the contract began, which is when the SIM first became active.

Example: 2023-06-28T05:52:03Z

contractEndDatestring · anulávelOpcional

When the contract ends, calculated from the contract start date and the contract period in the package.

Example: 2026-06-28T05:52:03Z

commsProfileIdintegerOpcional

The communications profile applied to the SIM, which defines its network configuration.

Example: 20888

statusstring · enumOpcional

Whether the record is still attached to its parent object.

Value	Meaning
active	The record is attached to the parent object.
deleted	The record is no longer attached to the parent object.

Example: activeValores possíveis:

400

The request contained an invalid parameter. additionalDetails lists the fields that failed validation.

application/json

403

The token is valid, but the service account does not have permission for this operation.

application/json

404

An entity referenced in the request does not exist. The message and additionalDetails name what could not be resolved.

application/json

patch/api/v2/sim/{iccId}/iccPortfolioPackage

PATCH /api/v2/sim/{iccId}/iccPortfolioPackage HTTP/1.1
Host: sim.api.anynetiot.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 50

{
  "portfolioId": "a628ebc659f7dac01f9fdcbd1116307a"
}

{
  "icc2PortfolioPackageId": 8944500000000000000,
  "iccId": "8944500000000000123",
  "portfolioId": "a628ebc659f7dac01f9fdcbd1116307a",
  "portfolioStartDate": "2026-08-03T00:00:00Z",
  "packageId": 20888,
  "packageStartDate": "2026-03-20T00:00:00Z",
  "contractStartDate": "2023-06-28T05:52:03Z",
  "contractEndDate": "2023-08-28T05:52:03Z",
  "commsProfileId": 20888,
  "status": "active"
}