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

# Exportar entradas de leads

> GET /lead/{lead_id}/entry/export/

Descarga las entradas de una lista de leads como un archivo CSV o Excel.

<Note>
  Requiere una clave de API de gestión con cuota `MANAGEMENT_API` (o `MANAGEMENT_API_SANDBOX`) y el permiso `LEAD_GENERATION_ENTRY_CAN_VIEW`, enviada como el valor sin procesar del encabezado `Authorization` — consulte el [resumen de la API de gestión](/es/api-reference/management-api/overview).
</Note>

<ParamField path="lead_id" type="string" required>
  El `lead_id` de la lista de leads.
</ParamField>

<ParamField query="file_format" type="string" default="csv">
  `csv`, `xls` o `xlsx`.
</ParamField>

<ParamField query="from" type="string">
  Solo entradas creadas en o después de esta fecha (`YYYY-MM-DD`).
</ParamField>

<ParamField query="to" type="string">
  Solo entradas creadas en o antes de esta fecha (`YYYY-MM-DD`).
</ParamField>

<ParamField query="ids" type="string">
  UUIDs de entradas separados por comas para limitar la exportación a una selección específica — refleja la acción "descargar seleccionados" del panel. Los UUID inválidos se ignoran silenciosamente en lugar de rechazarse.
</ParamField>

<ParamField query="search" type="string">
  La misma búsqueda de subcadena que [Listar entradas de leads](/es/api-reference/management-api/leads/entry-list) — refleja "descargar resultados filtrados".
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.scanova.io/lead/L9c2f4a1e/entry/export/?file_format=csv&from=2026-08-01&to=2026-08-31' \
    --header 'Authorization: YOUR_API_KEY' \
    --output entries.csv
  ```
</RequestExample>

La respuesta es una descarga de archivo (`Content-Type: text/csv`, o el tipo MIME de XLSX para `xls`/`xlsx`), no JSON, con `Content-Disposition: attachment; filename=<LeadListName>-<timestamp>.<ext>`.

<Note>
  El archivo exportado siempre incluye una columna `tracking_id`, independientemente de los permisos de seguimiento en cualquier otro lugar de la cuenta. Si un código QR emisor ha sido eliminado desde entonces, su valor de columna se representa como `<qrid> (Deleted)` en lugar de fallar la exportación. Con cero entradas coincidentes, el archivo aún contiene una fila de encabezado (derivada de las etiquetas de las preguntas del propio formulario de leads) en lugar de estar vacío.
</Note>

<Warning>
  En una cuenta de plan gratuito (`plan_type` 1), la exportación se limita a 25 filas — si hubiera más entradas coincidentes, se añaden dos filas finales indicando el límite e invitando a actualizar.
</Warning>

`400` con un cuerpo de texto sin formato (no la forma de error estándar de DRF) si `file_format` no es `csv`, `xls` o `xlsx`:

```json 400 theme={null}
{ "detail": "requested file format unknown" }
```

## Relacionado

* [Listar entradas de leads](/es/api-reference/management-api/leads/entry-list) — el equivalente en JSON, con los mismos filtros.
* [Resumen de la API de gestión](/es/api-reference/management-api/overview) — el esquema de autenticación y la arquitectura de cuotas a la que pertenece este endpoint.


## OpenAPI

````yaml api-reference/openapi/management-api.json GET /lead/{lead_id}/entry/export/
openapi: 3.1.0
info:
  title: Scanova Management API (v2)
  description: >-
    The complete Scanova Management API — every endpoint available at
    api.scanova.io (QR codes, folders, tags, leads, forms, analytics, plans,
    shared users & roles), plus the token-creation and usage-stats endpoints
    used to authenticate against it. Every path and request/response shape below
    was verified live against a real API key and the actual running backend
    (Phase 7, 2026-08-16) — not guessed from reading urls.py alone.
  version: 2.0.0
servers:
  - url: https://api.scanova.io
    description: Management API — QR/folder/tag/lead/form/analytics/plans endpoints
security:
  - apiKeyAuth: []
paths:
  /lead/{lead_id}/entry/export/:
    get:
      summary: Export lead entries
      operationId: exportManagedLeadEntries
      responses:
        '200':
          description: CSV or XLSX file download.
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Send your Management API key as the raw value of the Authorization
        header — no "Bearer " or "Token " prefix, and no other characters.
        Example: `Authorization: 401f7ac837da42b97f613d789819ff93537bee6a`. A
        header containing more than one space-separated part is rejected
        outright. Requests also require the request's Host header to be the
        management API host (e.g. api.scanova.io) — the same key sent to the
        regular API host will not authenticate.

````