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

# Busca status de todas as contas

> Recupera atualizações nos status das mensagens to-mobile submetidas desde o horário especificado (UTC). 
Serão recuperadas atualizações das mensagens to-mobile pertencentes à conta que está fazendo a chamada e TODAS as suas subcontas. (Autenticação roles: SuperAccountUser, Provisioning)



## OpenAPI

````yaml GET /api/v{version}/get/subaccounts/fw_status_updates
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}/get/subaccounts/fw_status_updates:
    get:
      tags:
        - Get
      summary: "Recupera atualizações nos status das mensagens to-mobile submetidas desde o horário especificado (UTC). \r\nSerão recuperadas atualizações das mensagens to-mobile pertencentes à conta que está fazendo a chamada e TODAS as suas subcontas. (Autenticação roles: SuperAccountUser, Provisioning)"
      description: "Recupera atualizações nos status das mensagens to-mobile submetidas desde o horário especificado (UTC). \r\nSerão recuperadas atualizações das mensagens to-mobile pertencentes à conta que está fazendo a chamada e TODAS as suas subcontas. (Autenticação roles: SuperAccountUser, Provisioning)"
      parameters:
        - name: FromUTC
          in: query
          description: >-
            Recupera registros de status das mensagens das subcontas atualizados
            após FromUTC. O formato do 'FromUTC': 'yyyy-MM-dd HH24:mm:ss'
          schema:
            type: string
        - 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/GetForwardStatusesResponse'
              example:
                Statuses:
                  - ID: 10844864715
                    IsClosed: true
                    State: 1
                    CreateUTC: '2022-11-25 12:00:20'
                    StatusUTC: '2022-11-25 12:00:23'
                    Transport: 1
                    RegionName: AMERRB8
                    ReferenceNumber: 41
                  - ID: 10844864716
                    IsClosed: false
                    State: 0
                    CreateUTC: '2022-11-25 12:00:00'
                    StatusUTC: '2022-11-25 12:00:15'
                    Transport: 1
                    ReferenceNumber: 20
                  - ID: 10844864806
                    ErrorID: 14
        '401':
          description: Falha na autenticação e autorização
          content:
            application/json:
              example: Falha na autenticação e autorização
        '403':
          description: >-
            Quando o usuário não for um SuperAccountUser, a API retornará o
            código HTTP 403 “Proibido”
          content:
            application/json:
              example: >-
                Quando o usuário não for um SuperAccountUser, 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:
    GetForwardStatusesResponse:
      description: >-
        Contém uma lista dos status das Mensagens encaminhadas (to-mobile)
        solicitadas.
      properties:
        ErrorID:
          description: >-
            Presente somente em caso de falha. O valor ErrorID serve como
            referência para entender a causa do erro.
          example: 0
        NextFromUTC:
          description: "Para 'fw_status_updates', o parâmetro 'fromUTC' da próxima requisição deve ser definido com este valor.\r\nSe você faz polling regular para mudanças de status das mensagens to-mobile, deve usar essa marcação retornada (high-water mark) nas requisições seguintes.\r\nReusar valores de marcação (FromUTC) enquanto obtém um grande número de registros pode resultar em limitação (throttling) das suas próximas requisições."
        Statuses:
          description: >-
            Array de registros de status das Mensagens FW (to-mobile)
            solicitadas.

````