v1

latestOpenAPI 3.1.02026-07-241630614.2 KB

Incoming leads list

This method allows getting a list of the incoming leads in the account

get/api/v4/leads/unsorted

Query parameters

pageinteger

Page number

limitinteger

The number of the entities returned in the response to one request (limit – 250)

filter[uid]string[]

Filter by the incoming lead UID. Either a single UID or an array of UIDs can be passed

filter[category]string[]

Filter by the incoming leads categories (sip, mail, forms, chats)

filter[pipeline_id]integer

Filter by the pipeline ID

order[created_at]string

Sorting the results. Available values for sorting: asc, desc.

Response

200

_pageinteger

Example response

{
  "_page": 1,
  "_links": {
    "self": {
      "href": "https://devteam.kommo.com/api/v4/leads/unsorted"
    }
  },
  "_embedded": {
    "unsorted": [
      {
        "uid": "5af9dedb6f2c6a29eaac6ee37fc75ffbb66e139e4603bdd0e14e39d4b319",
        "category": "forms",
        "pipeline_id": 6950551,
        "created_at": 1686819152,
        "metadata": {
          "form_id": "1115559",
          "form_name": "Form #1686818993",
          "form_page": "Site request #1115559 from form «Form #1686818993»",
          "ip": "212.46.197.210",
          "form_sent_at": "1686819152",
          "referer": "https://devteam.kommo.com/"
        },
        "account_id": 31361463,
        "_links": {
          "self": {
            "href": "LINK"
          }
        },
        "_embedded": {
          "contacts": [
            {
              "id": 583338,
              "_links": {
                "self": {
                  "href": "https://devteam.kommo.com/api/v4/contacts/583338"
                }
              }
            }
          ],
          "leads": [
            {
              "id": 236768,
              "_links": {
                "self": {
                  "href": "https://devteam.kommo.com/api/v4/leads/236768"
                }
              }
            }
          ]
        }
      }
    ]
  }
}