For AI agents: markdown of this page — /docs-content-en/entities/crm-deliveries.md documentation index — /llms.txt

CRM deliveries

Reading the deliveries of a CRM item, such as a deal: delivery service, cost and the "shipped" mark. Creating deliveries and acting on them is covered in the Shipments section.

Bitrix24 API: crm.item.delivery.* Scope: crm

List CRM deliveries

GET /v1/crm-deliveries

Returns all deliveries of a CRM item, such as a deal, in one call.

Parameters

Parameter Type Required Description
ParameterentityTypeId (query) Typenumber Requiredyes DescriptionCRM item type, a positive integer. For a deal — 2
ParameterentityId (query) Typenumber Requiredyes DescriptionCRM item ID, a positive integer. For a deal — the ID from GET /v1/deals

There is no pagination or sorting: all deliveries of the item are returned.

The generic filter parameter is not applied by this endpoint. By default, the API preserves the previous HTTP 200 response and data, adds Warning: 299 - "filter is not supported on this endpoint and was ignored", and records unsupported-filter use in the server log.

Examples

curl — personal key

Terminal 
curl "https://vibecode.bitrix24.com/v1/crm-deliveries?entityTypeId=2&entityId=8847" \
  -H "X-Api-Key: YOUR_API_KEY"

curl — OAuth application

Terminal 
curl "https://vibecode.bitrix24.com/v1/crm-deliveries?entityTypeId=2&entityId=8847" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

JavaScript — personal key

javascript 
const res = await fetch('https://vibecode.bitrix24.com/v1/crm-deliveries?entityTypeId=2&entityId=8847', {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' },
})

const { data, meta } = await res.json()
console.log(`Deliveries: ${meta.total}`)

JavaScript — OAuth application

javascript 
const res = await fetch('https://vibecode.bitrix24.com/v1/crm-deliveries?entityTypeId=2&entityId=8847', {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})

const { data, meta } = await res.json()

Response fields

Field Type Description
Fieldsuccess Typeboolean Descriptiontrue on success
Fielddata Typearray DescriptionThe item's deliveries. An empty array for an existing item with no deliveries
Fielddata[].id Typenumber DescriptionDelivery ID. The shipment in GET /v1/shipments/:id has the same ID
Fielddata[].accountNumber Typestring DescriptionDelivery number: the order number and a sequence number separated by /
Fielddata[].deducted Typestring DescriptionShipped flag: Y — shipped, N — not shipped
Fielddata[].dateDeducted Typestring | null DescriptionShipping time, or null until shipped
Fielddata[].deliveryId Typenumber DescriptionDelivery service ID. List: GET /v1/delivery-services
Fielddata[].priceDelivery Typenumber DescriptionDelivery cost
Fielddata[].currency Typestring DescriptionCurrency code of the cost
Fielddata[].deliveryName Typestring DescriptionDelivery service name
Fieldmeta.total Typenumber DescriptionNumber of deliveries in data

Response example

JSON 
{
  "success": true,
  "data": [
    {
      "id": 1223,
      "accountNumber": "1041/2",
      "deducted": "N",
      "dateDeducted": null,
      "deliveryId": 1,
      "priceDelivery": 500,
      "currency": "USD",
      "deliveryName": "Courier delivery"
    }
  ],
  "meta": {
    "total": 1
  }
}

Error response example

400 — entityId not provided:

JSON 
{
  "success": false,
  "error": {
    "code": "MISSING_REQUIRED_FIELDS",
    "message": "entityTypeId and entityId are required positive integers."
  }
}

Errors

HTTP Code Description
HTTP200 CodeWarning: 299 DescriptionThe filter is ignored by default; previous data is preserved and the warning is sent in the Warning header.
HTTP400 (strict mode only) CodeUNSUPPORTED_FILTER DescriptionThe server mode is disabled by default; until it is enabled, the endpoint preserves HTTP 200 and the previous data.
HTTP400 CodeMISSING_REQUIRED_FIELDS DescriptionentityTypeId or entityId not provided, or the value is not a positive integer
HTTP404 CodeENTITY_NOT_FOUND DescriptionNo CRM item with these entityTypeId and entityId
HTTP403 CodeSCOPE_DENIED DescriptionThe key lacks the crm scope
HTTP401 CodeTOKEN_MISSING DescriptionThe key has no Bitrix24 connection

Full list of common API errors — Errors.

Known specifics

deducted is a string here. The same delivery in GET /v1/shipments/:id returns deducted as true or false. Compare with "Y", not with true.

See also