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

# List custom company attributes

`GET /v2/api/crm/companies/attributes`

## Request

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

Returns the custom attributes defined on your team's companies, paginated, including the ones synced from your CRM integrations. Archived attributes are not listed. Only available to teams on the new contact model.

## Query parameters

- `page` integer
- `size` integer

## Response `200`

List of company attributes

- object
  - `data` CompanyAttribute[]
    - `key` string: Unique key within your team
    - `label` string, nullable: Display name
    - `type` 'TEXT' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'DROPDOWN', nullable
    - `options` CompanyAttributeOption[], nullable: Allowed values. Only set for `DROPDOWN` attributes.
      - `key` string
      - `label` string
    - `is_visible` boolean: Whether the attribute is shown in the Allo apps
    - `prompt` string, nullable: Instruction the AI CRM Manager follows to fill this attribute from calls. A blank value clears it.
    - `should_prompt_override` boolean, nullable: Whether the AI may overwrite a value that is already set
    - `source` string: `allo` for attributes created in Allo or with the API, otherwise the lowercase name of the integration that manages it, such as `hubspot`
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `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/companies/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)