> ## Documentation Index
> Fetch the complete documentation index at: https://doc.allcomtelecom.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Devices

> Retornar a lista de dispositivos de um cliente MoT. A lista em questão está pginada com filtros. (Possui dados sensíveis).



## OpenAPI

````yaml GET /broker/devices
openapi: 3.0.1
info:
  title: OpenAPI Auth Store
  description: API de exemplo para demonstração de autenticação e obtenção de tokens.
  license:
    name: Allcom Telecom
  version: 1.0.0
servers:
  - url: >-
      https://apicorp.algartelecom.com.br/telecom/product-Inventory-management/management/v1
security: []
paths:
  /broker/devices:
    get:
      description: >-
        Retornar a lista de dispositivos de um cliente MoT. A lista em questão
        está pginada com filtros. (Possui dados sensíveis).
      parameters:
        - name: Content-Type
          in: header
          required: true
          description: |-
            Define o formato da requisição.

            🔹 **Valor padrão:**
            ```
            application/json
            ```
            📌 **Dica:** Copie e cole esse valor no campo Content-Type.
          schema:
            type: string
            example: application/json
            default: application/json
        - name: client_id
          in: header
          required: true
          schema:
            type: string
            example: client_id
        - name: access_token
          in: header
          required: true
          description: Token gerado.
          schema:
            type: string
            example: access_token
        - name: page
          in: query
          required: true
          description: Página
          schema:
            type: integer
            example: 1
        - name: linesPerPage
          in: query
          required: true
          description: Tamanho da página
          schema:
            type: integer
            example: 30
        - name: showContracted
          in: query
          description: Mostrar contrato
          schema:
            type: boolean
      responses:
        '200':
          description: Listagem de dispositivos retornada com sucesso.
          content:
            application/json:
              example:
                devices:
                  - id: 12548965
                    plan: IOT MONITORAMENTO - TODAS OPERADORAS - 5 MBYTES
                    idVirtualAccount: 888888
                    activationDate: '2019-03-28T00:00:19.928Z'
                    activationPrice: 10
                    automaticBlocking: string
                    blockedByDefault: null
                    brokerContractDesc: EXEMPLO 50MB INDIVIDUAL
                    brokerContractId: 77777
                    cancellationDate: '2024-12-30T17:39:32.727Z'
                    contractAssetNumber: A118430431
                    customerDocumentNumber: '45632199000109'
                    customerId: string
                    customerName: Empresa X
                    parentName: EXEMPLO COMUNICAÇÕES LTDA
                    parentDocumentNumber: '98765432000188'
                    franchising: 5
                    iccid: '11113202000000449000'
                    imeiLocked: true
                    imsi: '1111120200044773'
                    lastStatusUpdate: '2024-12-30T17:39:32.727Z'
                    lastUpdate: '2024-12-30T17:39:32.727Z'
                    loyaltyType: 1
                    mbExcPrice: 2
                    msisdn: '5510000004818'
                    networkBlockEndDate: '2024-12-30T17:39:32.727Z'
                    networkBlockStartDate: '2024-12-30T17:39:32.727Z'
                    networkBlockStatus: NONE
                    nickname: apelido
                    observation: string
                    operator: ALGAR TELECOM
                    penalty: null
                    preActivationDays: 15
                    preActivationEnd: '2025-04-01T03:00:00.000+00:00'
                    price: 5
                    sharedCredit: null
                    sharedFranchise: '10'
                    sharingType: SHARED
                    simcardCredit: 50
                    status: ACTIVE
                    subOperator: ALGAR
                    eligibleToSuspension: false
                    suspensionEndDate: '2024-12-30T17:39:32.727Z'
                    suspensionStartDate: '2024-12-30T17:39:32.727Z'
                    tradeInMonth: null
                    apn: apn.teste.br
                    imei: '05789654854859'
                    rat: 2G
                    hostname: 99.999.999.99
                    locationInfo: string
                    lastConnection: '2021-06-07T02:17:13.000Z'
                    online: false
                    connOperator: ALGAR
                    latitude: '-5.489552'
                    longitude: '-47.45366'
                    city: Uberlandia
                    state: Minas Gerais
                    zipCode: '38414158'
                    consumptionPercent: string
                    consumptionValidated: string
                    consumptionCurrentDay: string
                    consumption: string
                    assetParentIot: A5698745654
                    acronym: IOT_MULTICONECT_M2M
                    accountCredit: 0
                    isSuspendable: 'false'
                    suspensionInitialDate: '2024-12-30T17:39:32.727Z'
                    suspensionFinalDate: '2024-12-30T17:39:32.727Z'
                    logicNumber: '99999'
                    blockingType: string
                    blockingInitialDate: string
                    blockingFinalDate: string
                    cpfCnpj: '45632199000109'
                    roaming: null
                    lastAlertDateFrom: null
                    planType: PREPAID
                    ggsn: exemplo-ggsn
                    nuRenewals: 3
                    deviceNumber: GPRFB71D
        '400':
          description: Requisição mal formada.
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: string
                    description: Erro encontrado.
              example:
                errors: Parameter not found
        '401':
          description: Requisição requer autenticação.
        '403':
          description: O acesso ao recurso foi negado.
        '500':
          description: Erro Interno do servidor.

````