# CRM reference lists

CRM entity types and address types available in the Bitrix24 account. Use them to convert a numeric entity type into a letter code and to find the allowed address types.

Bitrix24 API: `crm.enum.ownertype`, `crm.enum.addresstype`

Scope: `crm`

## Operations

- [Entity types](./crm-enums/owner-types.md) — `GET /v1/crm-enums/owner-types`
- [Address types](./crm-enums/address-types.md) — `GET /v1/crm-enums/address-types`

## Key fields

Both reference lists return items of the same shape.

| Field | Description |
|------|----------|
| `id` | For an entity type, the `entityTypeId` used in CRM routes. For an address type, the `typeId` of the [address methods](/docs/entities/addresses) |
| `name` | Name in the Bitrix24 account language |
| `symbolCode` | Symbolic code of the entity type, for example `DEAL`. For address types it can be `null` |
| `symbolCodeShort` | Short code of the entity type, matches the `ownerType` of product rows, for example `D`. For address types it can be `null` |

## Before you start

1. **The reference lists are read-only.** A READONLY key works. The methods take no parameters.
2. **The contents depend on the Bitrix24 account.** Entity types include the smart processes of this account, and names come in the account language. Match items by `id` and symbolic codes, not by `name`.
3. **Entity types link numeric and letter designations.** CRM routes take a numeric `entityTypeId`, while product rows return a letter `ownerType`. The entity type reference list holds both values in one record.

## Typical scenario

1. Get the entity types: [`GET /v1/crm-enums/owner-types`](./crm-enums/owner-types.md).
2. Find the smart process you need by `symbolCode` and pass its `id` to [`/v1/items/:entityTypeId`](/docs/entities/items).
3. Before writing an address, get the address types: [`GET /v1/crm-enums/address-types`](./crm-enums/address-types.md), and pass the chosen `id` as `typeId` to the [address methods](/docs/entities/addresses).

## Limits

| Limit | Value |
|-------|----------|
| Pagination | none, the whole reference list is returned in a single response |
| Rate limit | shared across the Vibecode API — see [Limits and optimization](/docs/optimization) |

## See also

- [Addresses](/docs/entities/addresses)
- [Smart processes](/docs/entities/items)
- [CRM settings](/docs/entities/crm-settings)
- [API reference](/docs/api-reference)