---
title: "Listar formulários"
method: GET
path: "/api/management/get-forms"
tags: ["forms"]
---

# Listar formulários

`GET /api/management/get-forms`

Lista todos os formulários da conta, sem paginação, com seus campos e as contagens de campos e de respostas. Por padrão traz só os ativos. Conceito de formulário: [Formulários dinâmicos](https://docs.olie.ai/guides/forms/overview).

## Query parameters

- `search` string
- `id` string
- `filter[trashed]` string

## Response `200`

Sucesso

- object — Formulários da conta.
  - `response` boolean — Indicador de sucesso da requisição. Sempre true nas respostas bem-sucedidas.
  - `forms` object[] — Formulários encontrados.
    - `id` integer — ID do formulário.
    - `title` string — Título do formulário.
    - `frame_id` string, uuid — ID da conta dona do formulário.
    - `created_at` string, date-time — Data de criação do formulário.
    - `updated_at` string, date-time — Data da última alteração do formulário.
    - `deleted_at` string, date-time, nullable — Data de exclusão do formulário. Nulo quando ativo.
    - `edges_count` integer — Quantidade de campos ativos do formulário.
    - `answers_count` integer — Quantidade de registros (projetos, clientes, etc.) com ao menos uma resposta no formulário.
    - `edges` object[] — Campos do formulário, ordenados por index.
      - `id` integer — ID do campo.
      - `type` 'short_text' | 'long_text' | 'rich_text' | 'attachment' | 'checkbox' | 'user' | 'date' | 'date_and_time' | 'email' | 'phone' | 'select' | 'radio' | 'currency' | 'number' | 'link' | 'time' | 'contact' | 'customer' | 'project' | 'counter' | 'matrix' — Tipo do campo.
      - `label` string — Rótulo do campo.
      - `index` integer — Posição do campo no formulário (ordem crescente).
      - `help_text` string, nullable — Texto de ajuda exibido junto ao campo.
      - `description` string, nullable — Descrição do campo.
      - `options` union — Opções do campo: lista de textos para select, radio e checkbox; objeto com rows/columns para matrix; lista vazia nos demais tipos.
        - string[]
        - object
      - `initial_value` union — Valor pré-preenchido do campo, no mesmo formato de uma resposta daquele tipo.
        - string
        - number
        - unknown[]
          - unknown
        - object
      - `required` boolean — Se o preenchimento é obrigatório.
      - `custom_validation` string, nullable — Expressão regular que a resposta precisa atender.
      - `conditional` unknown
      - `form_id` integer — ID do formulário ao qual o campo pertence.
      - `created_at` string, date-time — Data de criação do campo.
      - `updated_at` string, date-time — Data da última alteração do campo.
      - `deleted_at` string, date-time, nullable — Data em que o campo foi arquivado. Nulo quando ativo.
      - `is_multiple` boolean — Se o campo aceita mais de um valor (ex.: vários links ou usuários).
      - `logical_operator` 'and' | 'or' — Como as regras condicionais do campo se combinam.
      - `is_migrated` boolean — Marcador interno de migração de dados. Pode ser ignorado.
      - `conditional_action` 'show' | 'hide' | 'null', nullable — O que acontece com o campo quando as regras são atendidas: show (exibe) ou hide (oculta). Nulo quando não há lógica condicional.
      - `conditionals` object[] — Regras condicionais do campo.
        - `id` integer — ID da regra.
        - `form_edge_id` integer — ID do campo que é mostrado ou ocultado pela regra.
        - `target_id` integer — ID do campo cuja resposta é avaliada.
        - `operator` 'equals' | 'not_equals' | 'contains' | 'not_contains' | 'greater_than' | 'less_than' | 'is_empty' | 'is_not_empty' | 'starts_with' | 'ends_with' | 'greater_than_or_equals' | 'less_than_or_equals' — Operador de comparação.
        - `value` union — Valor comparado com a resposta do campo avaliado.
          - string
          - number
          - string[]

## Changes

- **2026-09-22** `d71b18b1685d` — 9 breaking, 26 warning, 6 info
  - the response property `forms/items/edges/items/help_text` became nullable for the status `200`
  - response property `forms/items/edges/items/options` list-of-types was widened by adding types `object` to media type `application/json` of response `200`
  - the `forms/items/deleted_at` response's property type changed from no type to `string`, and format from no format to `date-time` for status `200`
  - the `forms/items/edges/items/conditional_action` response's property type changed from no type to `string` for status `200`
  - …37 more
- **2026-09-22** `b43a04f35145` — 3 info
  - added the new optional `query` request parameter `id`
  - added the new optional `query` request parameter `search`
  - added the media type `application/json` for the response with the status `200`

[Change history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/get-forms/get.md)

---

[API](https://skmtc.dev/olie-ai/apis/olie-api.md) · [All operations](https://skmtc.dev/olie-ai/apis/olie-api/llms.txt) · [OpenAPI document](https://skmtc.dev/olie-ai/apis/olie-api/revisions/d71b18b1685d?raw)