emnify Operator API

openapi: 3.2.0
info:
  title: Enterprise Operator API
  version: 1.0.0
  description: Management of network operators and their data
servers:
- url: https://cdn.emnify.net
  description: emnify REST API
tags:
- name: Operator
  description: Management of network operators and their data
paths:
  /api/v1/operator:
    get:
      operationId: operator_OperatorGet
      summary: List operators
      description: 'Required permissions Beta Learn more


        `Operator` + `List`


        Roles: Administrator User Observer


        Returns a collection of existing operators.


        It will return an array of items with following properties:


        * `id`: identifier of this operator

        * `name`: the official name of the operator

        * `name_and_country`: Name / Country (for easy access in the UI)

        * `country`: country object with the nested country `id`

        * `mnc`: Array of Mobile Network Codes (MNCs)

        * `tapcode`: Array of TAP Codes'
      tags:
      - Operator
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ApiV1OperatorGetResponsesContentApplicationJsonSchemaItems'
        '403':
          description: 'Your role doesn''t include the permission this endpoint requires.


            Most endpoints return `error_code`, `error_token`, and `message`.

            Some return only `status_code` and `message`.

            '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OperatorGetRequestForbiddenError'
      security:
      - bearerAuth: []
components:
  schemas:
    ApiV1OperatorGetResponsesContentApplicationJsonSchemaItemsCountry:
      type: object
      properties:
        id:
          type: integer
        name:
          type: string
        country_code:
          type: integer
        mcc:
          type: integer
        iso_code:
          type: string
        latitude:
          type: string
          title: float
        longitude:
          type: string
          title: float
      title: ApiV1OperatorGetResponsesContentApplicationJsonSchemaItemsCountry
    OperatorGetRequestForbiddenError:
      type: object
      properties:
        error_code:
          type: integer
        error_token:
          type: string
        status_code:
          type: integer
        message:
          type: string
      title: OperatorGetRequestForbiddenError
    ApiV1OperatorGetResponsesContentApplicationJsonSchemaItems:
      type: object
      properties:
        name:
          type: string
        country_name:
          type: string
        id:
          type: number
          format: double
        country:
          $ref: '#/components/schemas/ApiV1OperatorGetResponsesContentApplicationJsonSchemaItemsCountry'
      title: ApiV1OperatorGetResponsesContentApplicationJsonSchemaItems
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'An `auth_token` should be provided to authenticate a session.


        To obtain an `auth_token`, see the [`/api/v1/authenticate` **POST** request](/developers/api/authentication/authenticate).

        '
x-provenance:
  method: harvested
  publisher: emnify
  source: https://docs.emnify.com/openapi/enterprise.yaml
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)