---
title: "Get CRM entity items list"
method: GET
path: "/crm/v1/entities/{entity}"
tags: ["items"]
---

# Get CRM entity items list

`GET /crm/v1/entities/{entity}`

## Request

- Base URL: `https://{domain}.uspacy.ua`
- URL: `https://{domain}.uspacy.ua/crm/v1/entities/{entity}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/uspacy/apis/crm-service-2/docs/crm/v1/entities/:entity/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a paginated list of CRM entity items with metadata.
Supports pagination via `page` and `list` query parameters.
Example: `GET /crm/v1/entities/leads?page=1&list=20`

## Query parameters

- `page` integer
- `list` integer

## Response `200`

Successful response

- object
  - `data` object[]
    - `title` string
    - `owner` integer
    - `source` string
    - `email` object[]
      - `id` string
      - `type` string
      - `value` string
      - `main` boolean
    - `phone` object[]
      - `id` string
      - `type` 'WORK' | 'MOBILE' | 'HOME'
      - `value` string
      - `code` string
    - `messengers` object[]
      - `id` string
      - `type` string
      - `link` string
    - `id` integer
    - `created_by` integer
    - `changed_by` integer
    - `created_at` integer
    - `updated_at` integer
  - `meta` Meta
    - `currentPage` integer
    - `from` integer
    - `lastPage` integer
    - `links` object[]
      - `url` string
      - `label` string
      - `active` boolean
    - `path` string
    - `perPage` integer
    - `to` integer
    - `total` integer

## Other responses

- `401`: Access token is missing or invalid

---

[API](https://skmtc.dev/uspacy/apis/crm-service-2.md) - [All operations](https://skmtc.dev/uspacy/apis/crm-service-2/llms.txt) - [OpenAPI document](https://skmtc.dev/uspacy/apis/crm-service-2/revisions/f80578d43845?raw)