For AI agents: markdown of this page — /docs-content-en/entities-index.md documentation index — /llms.txt
Entity reference
Complete list of entities and specialized APIs with their available operations. Each entry lists the path, operation set, and required scope. The common request and response format is described in API overview.
Entities by section
CRM
| Entity | Path | Operations | Scope |
|---|---|---|---|
| Deals | /v1/deals |
list get create update delete fields search aggregate products |
crm |
| Contacts | /v1/contacts |
list get create update delete fields search aggregate |
crm |
| Companies | /v1/companies |
list get create update delete fields search aggregate |
crm |
| Leads | /v1/leads |
list get create update delete fields search aggregate products |
crm |
| Quotes | /v1/quotes |
list get create update delete fields search aggregate products |
crm |
| Invoices | /v1/invoices |
list get create update delete fields search aggregate products |
crm |
| Sales pipelines | /v1/deal-categories |
list get create update delete fields search aggregate |
crm |
| Pipelines | /v1/categories/:entityTypeId |
list get create update delete fields |
crm |
| Activities | /v1/activities |
list get create update delete fields search aggregate |
crm |
| Activity bindings | /v1/activities/:activityId/bindings |
list bind unbind move |
crm |
| Configurable activities | /v1/activity-configurable |
create get update |
crm |
| CRM call transcripts | /v1/activities/:activityId/transcript |
get |
crm |
| CRM products | /v1/products |
list get create update delete fields search aggregate |
crm |
| Product sections | /v1/product-sections |
list get create update delete fields search |
crm |
| Statuses and stages | /v1/statuses |
list get create update delete fields search aggregate |
crm |
| Currencies | /v1/currencies |
list get create update delete fields search aggregate |
crm |
| Requisites | /v1/requisites |
list get create update delete fields search aggregate |
crm |
| Requisite presets | /v1/requisite-presets |
list get create update delete fields search |
crm |
| Bank details | /v1/bank-details |
list get create update delete fields search |
crm |
| Addresses | /v1/addresses, /v1/addresses/:typeId/:entityTypeId/:entityId |
list get create update delete fields search |
crm |
| Requisite links | /v1/requisite-links, /v1/requisite-links/:entityTypeId/:entityId |
list get register unregister fields search |
crm |
| Timeline comments | /v1/timelines |
list get create update delete fields search |
crm |
| CRM card layout | /v1/crm/card-config/:entityTypeId |
get set reset force-common |
crm |
Smart processes
| Entity | Path | Operations | Scope |
|---|---|---|---|
| Smart processes | /v1/smart-processes |
list get create update delete fields search |
crm |
| Smart process items | /v1/items/:entityTypeId |
list get create update delete fields search aggregate products |
crm |
Tasks
| Entity | Path | Operations | Scope |
|---|---|---|---|
| Tasks | /v1/tasks |
list get create update delete fields search aggregate |
tasks |
| Task comments | /v1/tasks/:taskId/comments |
list get create update delete |
task |
| Task time tracking | /v1/tasks/:taskId/time |
list get create update delete |
task |
| Task chat | /v1/tasks/:taskId/chat/messages |
get |
task |
| Task change history | /v1/tasks/:taskId/history |
get |
task |
| Task kanban stages | /v1/tasks/stages/:entityId |
get |
task |
| Scrum (epics + placement) | /v1/scrum/epics, /v1/scrum/tasks/:taskId |
list get create update |
task |
Calendar
| Entity | Path | Operations | Scope |
|---|---|---|---|
| Calendar events | /v1/calendar-events |
list get create update delete fields |
calendar |
Drive
| Entity | Path | Operations | Scope |
|---|---|---|---|
| Files | /v1/files |
list get update delete fields search upload download moveto copyto |
disk |
| Folders | /v1/folders |
list get create update delete fields search |
disk |
| Storages | /v1/storages |
list get fields search |
disk |
Users and social network
| Entity | Path | Operations | Scope |
|---|---|---|---|
| Employees | /v1/users |
list get create invite update delete fields search aggregate |
user |
| Departments | /v1/departments |
list get create update delete fields search |
department |
| Workgroups | /v1/workgroups |
list get create update delete search fields |
sonet_group |
Trade catalog
| Entity | Path | Operations | Scope |
|---|---|---|---|
| Catalogs | /v1/catalogs |
list get search fields |
catalog |
| Catalog products | /v1/catalog-products |
list get create update delete fields search aggregate |
catalog |
| Catalog product properties | /v1/catalog-product-properties |
list get create update delete search fields |
catalog |
| Catalog sections | /v1/catalog-sections |
list get create update delete search aggregate |
catalog |
| Catalog prices | /v1/catalog-prices |
list get create update delete search fields |
catalog |
| Warehouses | /v1/warehouses |
list get create update delete stock |
catalog |
Online store
| Entity | Path | Operations | Scope |
|---|---|---|---|
| Orders | /v1/orders |
list get create update delete fields search aggregate |
sale |
| Payments | /v1/payments |
list get create update delete search aggregate |
sale |
| Basket items | /v1/basket-items |
list get create update delete search aggregate |
sale |
| Order statuses | /v1/order-statuses |
list get create update delete search aggregate |
sale |
Sites
| Entity | Path | Operations | Scope |
|---|---|---|---|
| Sites | /v1/sites |
list get create update delete search fields aggregate |
landing |
| Pages | /v1/pages |
list get create update delete search fields aggregate |
landing |
Document generator
| Entity | Path | Operations | Scope |
|---|---|---|---|
| Document templates | /v1/doc-templates |
list get create update delete fields search aggregate |
documentgenerator |
| Documents | /v1/documents |
list get create update delete fields search |
documentgenerator |
| Documents by CRM record | /v1/crm-documents |
list |
crm |
Booking
| Entity | Path | Operations | Scope |
|---|---|---|---|
| Bookings | /v1/bookings |
list get create update delete search fields |
booking |
Business processes
| Entity | Path | Operations | Scope |
|---|---|---|---|
| Business process templates | /v1/bizproc-templates |
list create update delete fields search |
bizproc |
| Business process activities | /v1/bizproc-activities |
list create update delete fields |
bizproc |
| Automation rules | /v1/bizproc-robots |
list create update delete fields |
bizproc |
Open Channels
| Entity | Path | Operations | Scope |
|---|---|---|---|
| Open Channel configurations | /v1/openline-configs |
list get create update delete search fields aggregate |
imopenlines |
Specialized APIs
These APIs have their own endpoints that go beyond standard CRUD:
| API | Path | Scope | Description |
|---|---|---|---|
| Bots | /v1/bots |
imbot |
Bot platform (imbot.v2): registration, messages, chats, commands, files |
| Chats | /v1/chats |
im |
IM Chat API: CRM entity chats, messages, group chats |
| Workflows | /v1/workflows |
bizproc |
Launch, list, terminate processes, events |
| Notifications | /v1/notifications |
im |
Notifications to Bitrix24 users |
| Telephony | /v1/calls, /v1/telephony-lines, /v1/voximplant-lines |
telephony |
Registering external calls in CRM, outbound calls, lines, statistics |
| Triggers | /v1/triggers |
crm |
CRM automation triggers: fire a trigger on a deal/lead |
| Timeline log | /v1/timeline-logs |
crm |
CRM timeline: actions, notes, pinning, binding to entities |
| Posts | /v1/posts |
log |
Feed: announcements, comments |
| User fields | /v1/userfields |
crm |
CRM user fields: deals, leads, contacts, companies, quotes |
| Stage history | /v1/stage-history |
crm |
History of CRM stage transitions |
| Duplicates | /v1/duplicates/find |
crm |
Find duplicates by phone/email |
| Scrum | /v1/scrum |
task |
Scrum epics + task placement: create/rename epics, bind tasks to epics, auto-backlog |
| Task chat | /v1/tasks/:taskId/chat/messages |
task |
Read the task chat from newest messages to oldest, cursor pagination. The key needs the im scope |
| CRM call transcripts | /v1/activities/:activityId/transcript |
crm |
Ready-made AI transcript of a client call by the call activity's activityId |
| Workday | /v1/workday |
timeman |
Work time tracking: open/close day, status, settings |
| Batch requests | /v1/batch |
* |
Up to 50 entity calls in a single request (1 rate-limit unit) |
Common capabilities
All entity endpoints support:
- Filtering:
?filter[stageId]=NEWor?filter[$gte][amount]=1000(MongoDB operators) - Sorting:
?sort=-createdAt(-prefix for descending order) - Pagination:
?limit=50&offset=100(auto-pagination when limit > 50) - Field selection:
?select=id,title,amount - Field transformation: camelCase names are automatically converted to Bitrix24 field names
- Field metadata:
GET /v1/{entity}/fieldsreturns field descriptions, including custom UF fields with labels. For enumeration fields, anitemsarray with available values is returned - Search:
POST /v1/{entity}/search— advanced search with automatic date-based splitting for large data sets - Aggregation:
POST /v1/{entity}/aggregate— count, sum, average, minimum, maximum over fields - Product rows: for CRM entities with products (deals, leads, quotes, invoices, smart process items), the routes
GET/POST/PUT/PATCH/DELETE /v1/{entity}/{id}/productsare available - Related data (include):
?include=company,contactloads related entities in a single request