---
title: "Lista de leads"
method: GET
path: "/api/v4/leads"
---

# Lista de leads

`GET /api/v4/leads`

Este método permite obtener una lista de leads en la cuenta.

## Query parameters

- `with` string
- `page` integer
- `limit` integer
- `query` string
- `order[created_at]` 'asc' | 'desc'
- `order[updated_at]` 'asc' | 'desc'
- `order[id]` 'asc' | 'desc'
- `filter[id][]` integer[]
- `filter[name][]` string[]
- `filter[price]` integer
- `filter[created_by][]` integer[]
- `filter[updated_by][]` integer[]
- `filter[responsible_user_id][]` integer[]
- `filter[created_at][from]` integer
- `filter[created_at][to]` integer
- `filter[updated_at][from]` integer
- `filter[updated_at][to]` integer
- `filter[closed_at][from]` integer
- `filter[closed_at][to]` integer
- `filter[closest_task_at][from]` integer
- `filter[closest_task_at][to]` integer
- `filter[pipeline_id][]` integer[]
- `filter[statuses][0][pipeline_id]` integer
- `filter[statuses][0][status_id]` integer

## Response `200`

200

- object
  - `_page` integer
  - `_links` object
    - `self` object
      - `href` string
  - `_embedded` object
    - `leads` object[]
      - `id` integer
      - `name` string
      - `price` integer
      - `responsible_user_id` integer
      - `group_id` integer
      - `status_id` integer
      - `pipeline_id` integer
      - `loss_reason_id` unknown
      - `created_by` integer
      - `updated_by` integer
      - `created_at` integer
      - `updated_at` integer
      - `closed_at` unknown
      - `closest_task_at` integer
      - `is_deleted` boolean
      - `custom_fields_values` object[]
        - `field_id` integer
        - `field_name` string
        - `field_code` unknown
        - `field_type` string
        - `values` object[]
          - `value` boolean
        - `is_computed` boolean
      - `score` unknown
      - `account_id` integer
      - `labor_cost` unknown
      - `is_price_computed` boolean
      - `source_id` integer
      - `is_price_modified_by_robot` boolean
      - `_links` object
        - `self` object
          - `href` string
      - `_embedded` object
        - `tags` unknown[]
          - unknown
        - `catalog_elements` unknown[]
          - unknown
        - `loss_reason` unknown[]
          - unknown
        - `companies` unknown[]
          - unknown
        - `contacts` unknown[]
          - unknown

## Other responses

- `204` — 204
- `400` — 400
- `401` — 401
- `403` — 403
- `429` — 429
- `500` — 500

---

[API](https://skmtc.net/kommo/apis/kommo-api.md) · [All operations](https://skmtc.net/kommo/apis/kommo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kommo/kommo-api/versions/e291c0b2038d/schema)