> ## 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.

# List headless enrichment executions

> Paginated, filterable read-only list of headless marketplace enrichment audit rows for the current organization. See request schema, response codes.

<Note>
  Part of the **headless** flow under **`/integration-execution`**. To execute a run, see [Execute without entity](/en/api-reference/integrations/execute-without-entity). Uses the same integration codes as the Marketplace ([Shared provider codes](/en/api-reference/integrations/shared-provider-codes)).
</Note>

## Overview

Paginated, filterable **read-only** list of headless audit rows for the **current organization**. List items omit heavy `result_summary_json`; use [Get by id](/en/api-reference/integrations/headless-executions-item) for full `resultSummary`.

## URL

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

## Query Parameters

<ParamField query="page" type="integer" default="1">1-based page index.</ParamField>
<ParamField query="perPage" type="integer" default="20">Page size (1–100).</ParamField>
<ParamField query="search" type="string">Case-insensitive match on **name snapshot**, **tax id**, or **integration code**.</ParamField>
<ParamField query="integration" type="string">Exact integration code filter.</ParamField>
<ParamField query="status" type="string" default="all">`all` | `ok` | `fail` (`ok` = `enrichmentSuccess`, `fail` = not).</ParamField>
<ParamField query="entityType" type="string" default="all">`all` | `person` | `company`.</ParamField>
<ParamField query="sortBy" type="string" default="createdAt">`createdAt` or `tokens` (tokens sort uses `costCents` / token pricing).</ParamField>
<ParamField query="sortDir" type="string" default="desc">`asc` or `desc`.</ParamField>

## Response

<ResponseField name="success" type="boolean">`true` on success.</ResponseField>
<ResponseField name="items" type="array">Rows without heavy `result_summary_json` (list stays lean).</ResponseField>
<ResponseField name="total" type="number">Total rows matching filters.</ResponseField>
<ResponseField name="page" type="number">Current page.</ResponseField>
<ResponseField name="perPage" type="number">Page size.</ResponseField>
<ResponseField name="totalPages" type="number">Ceiling of `total / perPage`.</ResponseField>

<ResponseField name="filterOptions.integrationCodes" type="array">
  Distinct integration codes present for the org (for building filters).
</ResponseField>
