List SIM boxes (paginated, filterable, aggregated)

get

https://megsapp-nova-stg.85.group/api/v1/sim-cards/boxes

Server-side aggregated box list with per-status counts, partner breakdown, and floater count. MVNO callers see every box; partner callers are auto-scoped to boxes containing their SIMs via PartnerScopeGuard (cross-tenant partnerId is rejected with 403). Filters (label, batchNumber, dates, partnerCount preset, statusMix preset) and pagination/sort are declared on SimBoxListQueryDto.

Access: Auth methods: JWT bearer. Requires permissions: sim:read.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

page

integer

≥ 1

Defaults to 1

Page number (1-based)

limit

integer

1 to 2000

Defaults to 20

Items per page

simType

string

enum

Only include SIMs of this type when aggregating boxes

Allowed:

label

string

Case-insensitive substring match on label

batchNumber

string

Exact match on batch number

partnerId

string

Filter boxes containing ≥1 SIM owned by this partner UUID

simInventoryOwnerPartnerId

string

Filter boxes containing stock owned by this SIM inventory owner partner UUID

partnerCount

string

enum

Allowed:

statusMix

string

enum

Allowed:

createdFrom

string

ISO date: include boxes created on/after

createdTo

string

ISO date: include boxes created on/before

sortBy

string

enum

Defaults to createdAt

Allowed:

sortOrder

string

enum

Defaults to DESC

Allowed:

Response

Language

Credentials

Bearer

JWT

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json