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

# Listar execuções headless

> Lista paginada e filtrável somente leitura da auditoria headless da organização atual — nas integrações marketplace gu1 para verificação e enriquecimento.

<Note>
  Fluxo **headless** sob **`/integration-execution`**. Para executar, veja [Executar sem entidade](/pt/api-reference/integrations/execute-without-entity). Códigos: [Códigos de provedores](/pt/api-reference/integrations/provider-codes).
</Note>

## Visão geral

Lista **somente leitura** com paginação e filtros. Itens não carregam o JSON pesado de `result_summary`; use [Detalhe por id](/pt/api-reference/integrations/headless-executions-item).

## URL

```
GET https://api.gu1.ai/integration-execution/headless-executions
```

## Query

<ParamField query="page" type="integer" default="1">Página (base 1).</ParamField>
<ParamField query="perPage" type="integer" default="20">Tamanho (1–100).</ParamField>
<ParamField query="search" type="string">Busca em nome, tax id ou código de integração.</ParamField>
<ParamField query="integration" type="string">Filtro exato por código.</ParamField>
<ParamField query="status" type="string" default="all">`all` | `ok` | `fail`.</ParamField>
<ParamField query="entityType" type="string" default="all">`all` | `person` | `company`.</ParamField>
<ParamField query="sortBy" type="string" default="createdAt">`createdAt` ou `tokens`.</ParamField>
<ParamField query="sortDir" type="string" default="desc">`asc` ou `desc`.</ParamField>

## Resposta

`success`, `items`, `total`, `page`, `perPage`, `totalPages`, `filterOptions.integrationCodes`.
