> ## 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.

# Lista terminais da conta do usuário

> Autenticação: Token Bearer

Limitação de taxa: sim (grupo INFO de métodos)   

Autorização: Conta de usuário

A chamada retorna no máximo PageSize registros TerminalInfo.
Os registros retornados são ordenados pelo ID principal do terminal.
A primeira chamada ao GetTerminalsInfo deve definir o parâmetro SinceID como uma string vazia, e todas as chamadas subsequentes devem passar o ID principal do terminal do final do resultado da chamada anterior.



## OpenAPI

````yaml GET /api/v{version}/info/terminals
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:
  /api/v{version}/info/terminals:
    get:
      tags:
        - Info
      summary: >-
        Recupera uma lista de informações dos terminais pertencentes à conta do
        chamador (Autenticação)
      description: "Autenticação: Token Bearer\r\n\r\nLimitação de taxa: sim (grupo INFO de métodos)   \r\n\r\nAutorização: Conta de usuário\r\n\r\nA chamada retorna no máximo PageSize registros TerminalInfo.\r\nOs registros retornados são ordenados pelo ID principal do terminal.\r\nA primeira chamada ao GetTerminalsInfo deve definir o parâmetro SinceID como uma string vazia, e todas as chamadas subsequentes devem passar o ID principal do terminal do final do resultado da chamada anterior."
      parameters:
        - name: SinceID
          in: query
          description: ID principal do último registro de terminal recuperado.
          schema:
            type: string
        - name: PageSize
          in: query
          description: >-
            Número máximo de registros de terminais a retornar na resposta. Se
            não especificado, o tamanho padrão da página será 1000. O valor do
            parâmetro não pode exceder 1000.
          schema:
            type: integer
            format: int32
        - name: version
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: >-
            Chamada realizada com sucesso. Verifique o ErrorID para possíveis
            erros.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTerminalsInfoResponse'
              example:
                Terminals:
                  - PrimeID: 01000005SKYCD96
                    UnitID: KAAA4235100020
                    Description: Terminal de teste 002
                    LastRegionName: AMERRB9
                    MTSN: 01000005SKYCD96
                    IMEI: '359739077429070'
                    LastRegistrationUTC: '2022-01-22 20:00:24'
                    LastRegistrationMessageID: 784365876345
                    LastSatelliteNetwork: 1
                    LastOperationMode: 0
                    LastCellAccessUTC: '2022-01-22 21:10:14'
                    UpdateUTC: '2022-01-22 21:10:14'
                  - PrimeID: KAAA4235100021
                    Description: OG-ISAT(Desk#2 - 01095071)
                    LastRegionName: AMERRB15
                    MTSN: 01095071SKY7658
                    LastRegistrationUTC: '2015-11-10 14:59:29'
                    LastRegistrationMessageID: 784365876344
                    LastSatelliteNetwork: 0
                    UpdateUTC: '2015-11-10 14:59:29'
                  - PrimeID: '359739077429074'
                    Description: Terminal de teste modo dual
                    IMEI: '359739077429074'
                    LastRegistrationUTC: '2015-11-10 14:59:29'
                    LastRegistrationMessageID: 784365876343
                    LastSatelliteNetwork: 0
                    PairedTerminalPrimeID: 01095071SKY7658
                    LastCellAccessUTC: '2015-11-10 14:59:29'
                    UpdateUTC: '2015-11-10 14:59:29'
        '401':
          description: Quando falha a autenticação e autorização
          content:
            application/json:
              example: Quando falha a autenticação e autorização
        '429':
          description: >-
            Quando o usuário ultrapassa o limite provisionado de requisições
            para o endpoint da API, será retornado o código HTTP 429 “Muitas
            Requisições”
          content:
            application/json:
              example: >-
                Quando o usuário ultrapassa o limite provisionado de requisições
                para o endpoint da API, será retornado o código HTTP 429 “Muitas
                Requisições”
components:
  schemas:
    GetTerminalsInfoResponse:
      description: >-
        Resposta de informações dos terminais - inclui uma lista dos registros
        de informações dos terminais das contas do usuário.
      properties:
        ErrorID:
          description: >-
            Presente somente em caso de falha. O valor ErrorID serve como
            referência para entender a causa do erro.
          example: 0
        Terminals:
          description: Array de registros de informações dos terminais.

````