---
title: "List custom contact fields"
method: GET
path: "/v2/api/crm/attributes"
tags: ["CRM"]
---

# List custom contact fields

`GET /v2/api/crm/attributes`

## Request

- Base URL: `https://api.withallo.com`
- URL: `https://api.withallo.com/v2/api/crm/attributes`
- Auth: API key in header `Authorization`

Returns the custom fields defined on your team's people, paginated. Includes the fields you created with the API and the ones synced from your CRM integrations. Archived fields and built-in fields such as name or company are not listed.

## Query parameters

- `page` integer
- `size` integer

## Response `200`

List of custom contact fields

- object
  - `data` CrmAttribute[]
    - `key` string: Unique key of the field within your team
    - `label` string, nullable: Display name of the field
    - `type` 'TEXT' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'DROPDOWN', nullable: Value type
    - `options` CompanyAttributeOption[], nullable: Allowed values. Only set for `DROPDOWN` fields.
      - `key` string
      - `label` string
    - `source` string: `allo` for fields created in Allo or with the API, otherwise the lowercase name of the integration that manages it, such as `hubspot`
  - `pagination` Pagination
    - `page` integer
    - `size` integer
    - `total_count` integer
    - `total_pages` integer
    - `has_more` boolean

## Other responses

- `400`: Invalid request parameters
- `401`: Invalid or missing API key
- `403`: API key lacks the required scope or access to the resource
- `404`: Resource not found
- `429`: Rate limit exceeded

## Changes

- **2026-11-03** `46c77103dd14`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/withallo/apis/allo-api/changes/v2/api/crm/attributes/get.md)

---

[API](https://skmtc.dev/withallo/apis/allo-api.md) - [All operations](https://skmtc.dev/withallo/apis/allo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withallo/apis/allo-api/revisions/46c77103dd14?raw)