# List operators

Returns the list of operators filtered by optional label and country filters.

Endpoint: GET /v3/operators
Version: 1.0.0
Security: ApiKeyAuth

## Query parameters:

  - `label` (string)
    Filter operators by label. Allowed values are Green, Aqua, Blue, Voilet, Red, Grey, Orange.
    Enum: "Green", "Aqua", "Blue", "Voilet", "Red", "Grey", "Orange"

  - `iso2_codes` (string)
    Comma separated list of ISO 2-letter country codes. For example: iso2_codes=MX,US

## Response 200 fields (application/json):

  - `error` (boolean, required)
    Indicates if there was an error in the request

  - `data` (array, required)
    An array of operator objects returned by the request

  - `data.operator_id` (string, required)
    The unique identifier for the operator
    Example: "2dea792a-2dea-492c-815d-8fb826be8d49"

  - `data.name` (string, required)
    The name of the operator
    Example: "AT&T USA"

  - `data.iso2` (string, required)
    ISO 2-letter country code
    Example: "US"

  - `data.supported_rats` (array, required)
    List of supported Radio Access Technologies (RATs)
    Example: ["4G","5G"]

  - `data.mcc_mnc` (array, required)
    List of MCC-MNC codes associated with the operator
    Example: ["310-680","310-410"]

## Response 401 fields (application/json):

  - `error` (boolean, required)
    Indicates whether an error occurred during the request
    Example: true

  - `message` (string, required)
    Error message describing the unauthorized access
    Example: "Unauthorized: API key is missing"