---
title: "List carriers with pagination"
method: GET
path: "/carriers"
tags: ["Carriers"]
---

# List carriers with pagination

`GET /carriers`

## Query parameters

- `page` integer — Page number
- `pageSize` integer — Items per page
- `country` string — Filter by country name
- `countryISO` string — Filter by country ISO code
- `orderBy` 'id' | 'mcc' | 'mnc' | 'operator' | 'country' | 'country_iso' — Field to order by
- `orderDir` 'asc' | 'desc' — Order direction

## Response `200`

OK

- ResponseCarrier
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `items` Carrier[], nullable, required
    - `$schema` string, uri — A URL to the JSON Schema for this object.
    - `company` string, required
    - `country` string, required
    - `country_code` string, required
    - `country_iso` string, required
    - `created_at` string, date-time, required
    - `detail_url` string, required
    - `gsm_bands` string, required
    - `id` integer, required
    - `lte_bands` string, required
    - `mcc` string, required
    - `mnc` string, required
    - `mobile_prefix` string, required
    - `nsn_size` string, required
    - `number_format` string, required
    - `operator` string, required
    - `protocols` string, required
    - `umts_bands` string, required
    - `website` string, required
  - `pagination` Meta, required
    - `hasNext` boolean, required
    - `hasPrev` boolean, required
    - `page` integer, required
    - `pageSize` integer, required
    - `pages` integer, required
    - `total` integer, required

## Other responses

- `default` — Error

---

[API](https://skmtc.dev/droidrun/apis/droidrun-cloud.md) · [All operations](https://skmtc.dev/droidrun/apis/droidrun-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/droidrun/droidrun-cloud/revisions/a1453ac769d4/schema)