> ## 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 de subconta desde um horário

> Autenticação: Token Bearer

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

Autorização: Usuário super-conta


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



## OpenAPI

````yaml GET /api/v{version}/info/subaccount/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/subaccount/terminals:
    get:
      tags:
        - Info
      summary: >-
        Recupera uma lista de informações dos terminais pertencentes à subconta
        do chamador (Papéis de autenticação: SuperAccountUser, Provisioning)
      description: "Autenticação: Token Bearer\r\n\r\nLimitação de taxa: sim (grupo INFO de métodos)\r\n\r\nAutorização: Usuário super-conta\r\n\r\n\r\nA chamada retorna no máximo PageSize registros do tipo TerminalInfo.\r\nOs registros resultantes são ordenados pelo prime ID do terminal.\r\nA primeira chamada para GetTerminalsInfo deve definir o parâmetro SinceID como string vazia, e todas as chamadas subsequentes devem usar o prime ID do terminal do final do resultado da chamada anterior."
      parameters:
        - name: SinceID
          in: query
          description: Prime ID do último registro de terminal recuperado.
          schema:
            type: string
        - name: PageSize
          in: query
          description: >-
            Número máximo de registros de terminais a serem retornados na
            resposta. Se não especificado, o tamanho padrão da página é 1000. O
            valor do parâmetro não pode exceder 1000.
          schema:
            type: integer
            format: int32
        - name: SubAccountID
          in: query
          description: ID da subconta para a qual a lista de terminais é solicitada.
          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 dual mode
                    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
        '403':
          description: >-
            Quando o chamador não for um usuário de super conta, a API retornará
            o código HTTP 403 “Proibido”
          content:
            application/json:
              example: >-
                Quando o chamador não for um usuário de super conta, a API
                retornará o código HTTP 403 “Proibido”
        '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.

````