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

# List column values

`GET /contacts/schema/{column}/values`

Returns the allowed slugs of one closed-list column, or the observed values of an open list column (city, region, skills). A column that identifies a person has no values route and is answered as not found. Free.

Returns the allowed slugs of one closed-list column, or the observed values of an open list column (city, region, skills). A column that identifies a person has no values route and is answered as not found. Free.

Cost: Free.

## Parameters

| Name | In | Type | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `column` | path | string | yes |  | The column name, as `GET /contacts/schema` prints it, for example `seniority`. |
| `q` | query | string | no |  | An optional search string that filters the values by slug or by label. |
| `limit` | query | integer | no | 100 | The maximum number of values to return. The default is 100. |

## Response

The values of the column. An open list comes most common first. A closed list comes in its published order, with count null.

- `value` | string | required. The canonical slug. Slugs never change.
- `label` | string | required. The display label. A label may change, so never store it.
- `count` | integer or null | optional. How many rows carry the value, or null when it was not computed.

## Failures

| Status | Meaning |
| --- | --- |
| `400` | The request shape, a filter key, a value, a cursor or the enrichment mode was rejected. |
| `401` | The credential is missing, unknown or revoked. |
| `404` | The id or the column does not exist, or the row was opted out. |
| `429` | The key passed 300 requests a minute or 2 concurrent requests. |
| `503` | The data is unavailable for a short time. |

## Example

```bash
curl -sS "https://api.leadmcp.ai/v1/contacts/schema/seniority/values" \
  -H "Authorization: Bearer lm_live_YOUR_API_KEY" \
  -H "LeadMCP-Version: 2026-09-19"
```

Response `200`:

```json
{
  "ok": true,
  "request_id": "req_01JBQ2W8K9V6M3T0X5Y7Z4A1BC",
  "release": "b_2026_09_15",
  "data": [
    {
      "value": "vp",
      "label": "Vice President",
      "count": 1842000
    },
    {
      "value": "director",
      "label": "Director",
      "count": 2910000
    }
  ],
  "quota": {
    "plan": "free",
    "contact_credits_used": 50,
    "month_remaining": 950,
    "today_remaining": 950,
    "binding": "month",
    "resets_at": "9999-12-31T23:59:59.000Z"
  },
  "warnings": []
}
```