# List lead properties

### List lead properties

`GET /api/v1/lead-properties`

Operation ID: `listLeadProperties`

Every custom property key used by leads in this workspace, with its type, how many leads have a value, and the most common values. Use these to build filters for POST /leads/search.

**200**: Custom properties, by key.

- `properties` (object[], required)
- `requestId` (string · uuid, required): Id of this request, for support and troubleshooting

**Errors**

- `400`: Bad request
- `401`: Unauthorized: missing or invalid API key
- `403`: Forbidden
- `404`: Not found
- `422`: Invalid request payload