---
title: "Search for people"
method: POST
path: "/v1/search/person"
tags: ["v1"]
---

# Search for people

`POST /v1/search/person`

## Request body

- PersonSearchRequest
  - `query` PersonSearchRequestQuery
    - `value` string, required — Search query to filter people.
  - `filters` PersonSearchFilter[] — Filters to filter people.
    - `value` string
    - `min` string
    - `max` string
    - `values` string[]
    - `keywords` string[]
    - `field` 'date_of_birth' | 'city' | 'active', required
  - `pagination` SearchRequestPagination
    - `page` integer — Page number to return.
    - `per_page` integer — Number of results per page.

## Response `200`

Successful search operation

- PersonSearchResponse
  - `results` PersonSearchResponseItem[], required — List of people matching the search criteria.
    - `id` string, required — Unique person identifier. Example: 1234-5678-9012-345678901234
    - `name` string, required — Name of the person. Example: "Max Mustermann"
    - `city` string, nullable, required — City of the person. Example: "Berlin"
    - `date_of_birth` string, date, required — Date of birth of the person. Format: ISO 8601 (YYYY-MM-DD) Example: "1990-01-01"
    - `active` boolean, required — Person status - true if active, false if inactive.
  - `pagination` Pagination, required
    - `page` integer, required — Current page number.
    - `per_page` integer, required — Number of results per page.
    - `total_pages` integer, required — Total number of pages.
    - `total_results` integer, required — Total number of results.

## Other responses

- `400` — Bad Request - Invalid parameters provided
- `401` — Unauthorized - Authentication required
- `402` — Payment Required - Insufficient credits for this request
- `429` — Too Many Requests - Rate limit exceeded
- `500` — Internal Server Error - An error occurred while processing the request

## Changes

- **2025-08-27** `b37d87e51e02` — 1 breaking, 2 info
  - the response property `results/items/city` became nullable for the status `200`
  - api tag `v1` added
  - the response property `results/items/city` became required for the status `200`
- **2025-08-04** `891be13f1b6a` — 2 breaking, 6 warning
  - added `#/components/schemas/SearchFilterBase, subschema #2` to the `filters/items/` request property `allOf` list
  - the `filters/items/` request property type/format changed from `object`/`` to ``/``
  - removed the request property `filters/items/field`
  - removed the request property `filters/items/keywords`
  - …4 more
- **2025-08-04** `78a4d9863b41` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/oregister/apis/openregister-api/changes/v1/search/person/post.md)

---

[API](https://skmtc.dev/oregister/apis/openregister-api.md) · [All operations](https://skmtc.dev/oregister/apis/openregister-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/oregister/openregister-api/revisions/d1fcaf6d6ca0/schema)