> ## 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 ejecuciones headless

> Listado paginado y filtrable en solo lectura de auditoría headless para la organización actual. Consulta el esquema del request, códigos de respuesta.

<Note>
  Flujo **headless** bajo **`/integration-execution`**. Para ejecutar una corrida, véase [Ejecutar sin entidad](/es/api-reference/integrations/execute-without-entity). Códigos de integración: [Códigos compartidos](/es/api-reference/integrations/provider-codes).
</Note>

## Resumen

Listado **solo lectura** con paginación y filtros. Las filas del listado no incluyen el JSON pesado de `result_summary`; el detalle completo está en [Detalle por id](/es/api-reference/integrations/headless-executions-item).

## URL

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

## Query

<ParamField query="page" type="integer" default="1">Índice de página (base 1).</ParamField>
<ParamField query="perPage" type="integer" default="20">Tamaño de página (1–100).</ParamField>
<ParamField query="search" type="string">Búsqueda insensible a mayúsculas en **nombre**, **tax id** o **código de integración**.</ParamField>
<ParamField query="integration" type="string">Filtro exacto por código de integración.</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` o `tokens`.</ParamField>
<ParamField query="sortDir" type="string" default="desc">`asc` o `desc`.</ParamField>

## Respuesta

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