---
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

---

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