> ## 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 subcontas da conta do usuário

> Autenticação: Token Bearer

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

Autorização: Usuário super-conta



## OpenAPI

````yaml GET /api/v{version}/info/subaccount/list
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/list:
    get:
      tags:
        - Info
      summary: >-
        Recupera uma lista de subcontas vinculadas à conta 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"
      parameters:
        - 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/GetSubaccountInfoResponse'
              example:
                Subaccounts:
                  - AccountID: 60023006
                    AccountName: Frota de caminhões A
                  - AccountID: 60023007
                    AccountName: Frota de caminhões B
        '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:
    GetSubaccountInfoResponse:
      description: Lista de subcontas vinculadas à conta solicitante.
      properties:
        ErrorID:
          description: >-
            Presente somente em caso de falha. O valor ErrorID serve como
            referência para entender a causa do erro.
          example: 0
        Subaccounts:
          description: "Array de registros de informações de conta.\r\n[JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]"

````