List all SIMs

Returns a paginated list of SIM records accessible to the current user. Supports filtering by ICCID (exact via iccid_eq, or partial via iccid_like / iccid_ilike), MSISDN, device, integration, status, and boolean flags. Pass page_meta=true to receive a paginated envelope ({ resources, page, per_page, total }); omit it to receive a plain array.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
integer
≥ 1
Defaults to 1

Page number for pagination

integer
1 to 100
Defaults to 20

Number of items per page

string

Filter SIMs whose ICCID exactly matches the given value.

string

Filter SIMs whose ICCID contains the given substring (case-sensitive). The value is matched as a substring — the server wraps it in % wildcards automatically, so pass the raw fragment without wildcards (e.g. 8910 matches any ICCID containing 8910). Use iccid_ilike for a case-insensitive match.

string

Filter SIMs whose ICCID contains the given substring (case-insensitive). Behaves like iccid_like but ignores case. The value is matched as a substring (the server wraps it in % wildcards), so pass the raw fragment without wildcards.

string

Filter SIMs whose MSISDN exactly matches the given value.

string

Filter SIMs linked to the specified device ID.

string

Filter SIMs associated with the specified integration ID.

string

Filter SIMs by lifecycle status. Accepts any string value (sim_status is an open field driven by the carrier/CMP).

boolean

Filter SIMs by whether they have been barred by the carrier.

boolean

Filter SIMs by whether they have reached their overage limit.

boolean
Defaults to false

Include pagination metadata in response

Responses

401

You are not authorized

404

The item you were looking for does not exist

500

An unexpected error was encountered.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json