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

# Listar formulários

> Lista os formulários do frame. Por padrão retorna apenas formulários ativos.

**Filtro de formulários deletados (soft delete):**

Utilize o parâmetro `filter[trashed]` para controlar a exibição:

| Valor | Comportamento |
| --- | --- |
| _(omitido)_ | Retorna apenas formulários ativos (padrão) |
| `with` | Retorna ativos + deletados |
| `only` | Retorna apenas os deletados |

**Exemplo:** `GET /api/management/get-forms?filter[trashed]=with`



## OpenAPI

````yaml /api-reference/openapi.json get /api/management/get-forms
openapi: 3.0.0
info:
  title: Olie API
  version: 1.0.0
  description: >
    # Introdução 👋


    Olá! Esta é a documentação oficial da API da [olie.ai](https://olie.ai/).
    Aqui você encontra as referências e exemplos de uso dos nossos endpoints.


    Para uma visão completa, recomendamos fortemente que você leia a
    [documentação oficial](https://docs.olie.ai/api-reference/introduction). Lá
    estão detalhados tópicos essenciais como
    [autenticação](https://docs.olie.ai/api-reference/introduction/authentication),
    [estrutura de
    respostas](https://docs.olie.ai/api-reference/general/response-structure),
    [paginação](https://docs.olie.ai/api-reference/general/pagination) e outros
    guias de integração.


    No Postman, esta coleção foca nas informações específicas de cada requisição
    (endpoints, parâmetros e exemplos), servindo como apoio rápido para testes e
    desenvolvimento.
servers:
  - url: https://api.olie.ai
security:
  - BearerAuth: []
paths:
  /api/management/get-forms:
    get:
      tags:
        - forms
      summary: Listar formulários
      description: >-
        Lista os formulários do frame. Por padrão retorna apenas formulários
        ativos.


        **Filtro de formulários deletados (soft delete):**


        Utilize o parâmetro `filter[trashed]` para controlar a exibição:


        | Valor | Comportamento |

        | --- | --- |

        | _(omitido)_ | Retorna apenas formulários ativos (padrão) |

        | `with` | Retorna ativos + deletados |

        | `only` | Retorna apenas os deletados |


        **Exemplo:** `GET /api/management/get-forms?filter[trashed]=with`
      operationId: listarFormulRios
      parameters:
        - name: filter[trashed]
          in: query
          description: >-
            Filtra formulários deletados (soft delete). Valores aceitos: `with`
            (ativos + deletados), `only` (somente deletados). Omita para
            retornar apenas ativos (padrão).
          schema:
            type: string
          example: with
      responses:
        '200':
          description: '200'
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````