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

# listarAudios

> <h2>Retorna lista de áudios</h2>

Retorna lista de todos os áudios ativos. É possível filtrar pela descrição do áudio.

###### Response:

<table><tbody><tr><td><div>audios</div></td><td><div><p>Lista de audios na seguinte estrutura:<br /><br /></p><div><table><tbody><tr><td><div>id</div></td><td><div>Id do áudio</div></td></tr><tr><td><div>descricao</div></td><td><div>Descrição do áudio</div></td></tr><tr><td><div>duracao</div></td><td><div>Duração do áudio em segundos</div></td></tr><tr><td><div>aprovado</div></td><td><div>Áudio aprovado (Y ou N)</div></td></tr><tr><td><div>data_criacao</div></td><td><div>Data de criação do áudio</div></td></tr><tr><td><div>data_alteracao</div></td><td><div>Data da última alteração do áudio</div></td></tr><tr><td><div>tipo</div></td><td><div>Tipo da origem do áudio: gravacao, upload ou texto</div></td></tr></tbody></table></div></div></td></tr></tbody></table>



## OpenAPI

````yaml /openapi.yaml post /ipbox/api/listarAudios
openapi: 3.0.0
info:
  title: IPBoX Api Documentation v1.1
  description: >-
    Nesse documento são descritos os comandos presentes na API Rest do IPBoX. Os
    comandos são executados com chamadas POST e com respostas em formato JSON.
  version: 1.0.0
servers:
  - url: https://{baseUrl}
    description: Dominio (e porta, se houver) do servidor IPBoX do cliente
    variables:
      baseUrl:
        default: cliente.ipboxcloud.com.br:9052
        description: >-
          Substitua pelo dominio real do seu servidor IPBoX. A maioria dos
          servidores usa uma porta especifica - inclua-a junto ao dominio (ex.:
          cliente.ipboxcloud.com.br:9052)
security:
  - ApiToken: []
tags:
  - name: Agente
  - name: Ligações
  - name: Prospects
  - name: Agendamentos
  - name: Listas
  - name: Filas
  - name: Lotes
  - name: Relatórios
  - name: Outros
  - name: Times
  - name: Blacklist
  - name: Áudios
  - name: URAs
paths:
  /ipbox/api/listarAudios:
    post:
      tags:
        - Áudios
      summary: listarAudios
      description: >-
        <h2>Retorna lista de áudios</h2>


        Retorna lista de todos os áudios ativos. É possível filtrar pela
        descrição do áudio.


        ###### Response:


        <table><tbody><tr><td><div>audios</div></td><td><div><p>Lista de audios
        na seguinte estrutura:<br /><br
        /></p><div><table><tbody><tr><td><div>id</div></td><td><div>Id do
        áudio</div></td></tr><tr><td><div>descricao</div></td><td><div>Descrição
        do áudio</div></td></tr><tr><td><div>duracao</div></td><td><div>Duração
        do áudio em
        segundos</div></td></tr><tr><td><div>aprovado</div></td><td><div>Áudio
        aprovado (Y ou
        N)</div></td></tr><tr><td><div>data_criacao</div></td><td><div>Data de
        criação do
        áudio</div></td></tr><tr><td><div>data_alteracao</div></td><td><div>Data
        da última alteração do
        áudio</div></td></tr><tr><td><div>tipo</div></td><td><div>Tipo da origem
        do áudio: gravacao, upload ou
        texto</div></td></tr></tbody></table></div></div></td></tr></tbody></table>
      parameters:
        - name: Authorization
          in: header
          schema:
            type: string
          example: '{{token}}'
        - name: Content-Type
          in: header
          schema:
            type: string
          example: application/x-www-form-urlencoded
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                descricao:
                  type: string
                  description: >-
                    [Opcional] Filtro pela descrição do áudio - se não
                    informado, retorna todos os áudios
                  example: descricao
      responses:
        '200':
          description: Successful response
          content:
            application/json: {}
components:
  securitySchemes:
    ApiToken:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Token gerado em IPBoX > API > Token. Aceita o token puro, ou com prefixo
        `Bearer ` / `Basic `.

````