# List Lead Fields

> List the workspace's lead custom fields.

> Documentation index: https://www.foxreach.io/docs/llms.txt lists every page of these docs. Each page is also served as Markdown: add `.md` to its URL.

`GET` https://api.foxreach.io/api/v1/lead-fields

Defined fields come first, in their order, then keys that leads carry without a definition (from imports or the API), sorted by name, with `defined: false`.

## Response

- `data` object[]

  Field objects, see [Create Lead Field](https://www.foxreach.io/docs/api-reference/lead-fields/create-lead-field) for the shape.

**Request example**

```bash cURL
curl "https://api.foxreach.io/api/v1/lead-fields" \
  -H "X-API-Key: otr_your_key"
```

**Response example**

```json
{
  "data": [
    { "id": "clf_abc123", "key": "Industry", "type": "select", "options": ["SaaS", "Agency"], "position": 1, "defined": true, "leadCount": 412 },
    { "id": null, "key": "signal", "type": "text", "options": [], "position": null, "defined": false, "leadCount": 87 }
  ]
}
```

## Rate Limit

- **300 requests per minute, shared by every `read` call in your workspace.** Fixed 60-second window.
- Every response includes `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` (unix epoch seconds) and `X-RateLimit-Bucket` (`read`).
- A `429` response includes a `Retry-After` header (seconds until the bucket resets).

For client-side patterns, see [Rate Limiting](https://www.foxreach.io/docs/rate-limiting).
