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

# Formato de respuesta

> Estructuras JSON para recursos individuales, colecciones, listas paginadas y errores.

Todas las respuestas son JSON con `Content-Type: application/json`.

## Recurso individual

```json theme={null}
{
  "id": "lead_f0a3...",
  "firstName": "Ada",
  "lastName": "Lovelace",
  "...": "..."
}
```

El cuerpo es el recurso en sí, sin envoltorio. Los campos que no estableces vuelven como `null` (no omitidos), así que el destructuring es seguro.

## Colección (no paginada)

Para endpoints que devuelven un catálogo de tamaño fijo (tipos de eventos, fuentes de leads, etapas del pipeline):

```json theme={null}
{
  "data": [
    { "id": "website", "name": "website" },
    { "id": "meta", "name": "meta" }
  ]
}
```

## Lista paginada

Para endpoints de lista:

```json theme={null}
{
  "data": [ /* array de recursos */ ],
  "pagination": {
    "total": 327,
    "limit": 50,
    "offset": 0,
    "hasMore": true
  }
}
```

Ver [Paginación](/es/pagination) para cómo recorrer páginas.

## Error

```json theme={null}
{
  "error": {
    "message": "Has alcanzado el número máximo de leads de tu plan. Actualiza para crear más leads.",
    "code": "FORBIDDEN"
  }
}
```

El status HTTP y el `error.code` siempre son consistentes (p.ej. `403` ↔ `FORBIDDEN`, `404` ↔ `NOT_FOUND`). Ver tabla completa en [Errores](/es/errors).

## Timestamps

Todas las marcas de tiempo son strings ISO 8601 en UTC, p.ej. `"2026-04-29T18:04:15.000Z"`. Parséalas con la librería estándar de tu lenguaje — siempre incluyen el sufijo `Z` y precisión de milisegundos.

## IDs

Los IDs de recursos son strings opacos. No intentes parsearlos ni asumir un formato específico — pueden cambiar en futuras versiones.