---
title: "Универсальный поиск с фильтрами"
method: GET
path: "/v1.4/person"
tags: ["Актеры, режиссеры, операторы, и т.д"]
---

# Универсальный поиск с фильтрами

`GET /v1.4/person`

Этот метод вернет список персон удовлетворяющих вашему запросу. <br> В ответе придут поля указанные в параметре `selectFields`. Если его не указать, то вернутся только дефолтные поля.

## Query parameters

- `page` number
- `limit` number
- `selectFields` string[]
- `notNullFields` string[]
- `sortField` string[]
- `sortType` string[]
- `id` string[], nullable
- `movies.id` string[], nullable
- `sex` string[], nullable
- `growth` string[], nullable
- `birthday` string[], nullable
- `death` string[], nullable
- `age` string[], nullable
- `birthPlace.value` string[], nullable
- `deathPlace.value` string[], nullable
- `spouses.id` string[], nullable
- `spouses.divorced` string, nullable
- `spouses.sex` string[], nullable
- `countAwards` string[], nullable
- `profession.value` string[], nullable
- `movies.rating` string[], nullable
- `movies.enProfession` string[], nullable
- `updatedAt` string[], nullable
- `createdAt` string[], nullable

## Response `200`

- PersonDocsResponseDtoV14
  - `docs` Person[], required
    - `id` number, required
    - `name` string, nullable
    - `enName` string, nullable
    - `photo` string, nullable
    - `sex` string, nullable
    - `growth` number, nullable
    - `birthday` string, nullable
    - `death` string, nullable
    - `age` number, nullable
    - `birthPlace` BirthPlace[]
      - `value` string
    - `deathPlace` DeathPlace[]
      - `value` string
    - `spouses` Spouses
      - `id` number
      - `name` string
      - `divorced` boolean
      - `divorcedReason` string
      - `sex` string
      - `children` number
      - `relation` string
    - `countAwards` number
    - `profession` Profession[]
      - `value` string
    - `facts` FactInPerson[]
      - `value` string
    - `movies` MovieInPerson[]
      - `id` number, required
      - `name` string, nullable
      - `alternativeName` string, nullable
      - `rating` number, nullable
      - `general` boolean, nullable
      - `description` string, nullable
      - `enProfession` string, nullable
    - `updatedAt` string, date-time, required
    - `createdAt` string, date-time, required
  - `total` number, required — Общее количество результатов
  - `limit` number, required — Количество результатов на странице
  - `page` number, required — Текущая страница
  - `pages` number, required — Сколько страниц всего

---

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