---
title: "Vyhľadá identity podľa kritérií"
method: POST
path: "/api/iam/identities/search"
tags: ["Vyhľadávanie identít (dostupné len pre OVM)"]
---

# Vyhľadá identity podľa kritérií

`POST /api/iam/identities/search`

Vyhľadá identity podľa kritérií.

Pozor, volanie je dostupné len pre OVM.

## Request body

- object
  - `ids` string[] — ID identít.
  - `uris` string[] — URI identít.
  - `en` string — Identifikátor schránky.
  - `type` 'natural_person' | 'legal_entity' | 'technical_account' | 'administrator_crap' | 'employee_of_public_administration' | 'institution_of_public_administration' | 'edemocracy_user' — Typ identity: - `natural_person` fyzická osoba, - `legal_entity` právnická osoba, - `technical_account` technický účet, - `employee_of_public_administration` zamestnanec verejnej správy, - `institution_of_public_administration` orgán verejnej moci.
  - `email` string, email
  - `phone` string, phone
  - `address` object — Adresa trvalého pobytu alebo kontaktná adresa.
    - `type` 'contact' | 'resident', required — Typ adresy: - `contact` kontaktná adresa, - `resident` adresa trvalého pobytu.
    - `country` object — Krajina podľa číselníka ŠÚSR 0086
      - `id` string
      - `name` string
    - `district` object — Okres podľa číselníka ŠÚSR 0024.
      - `id` string
      - `name` string
    - `municipality` object — Obec podľa číselníka ŠÚSR 0025.
      - `id` string
      - `name` string
    - `street` string — Ulica.
    - `building_number` string — Orientačné číslo budovy.
    - `registration_number` integer — Súpisné číslo budovy.
  - `legal_entity` object — Právnická osoba.
    - `cin` integer — IČO.
    - `tin` integer — DIČ.
    - `name` string — Názov.
  - `natural_person` object — Fyzická osoba.
    - `given_name` string — Meno. Pozri `match`.
    - `family_name` string — Priezvisko. Pozri `match`.
    - `date_of_birth` string, date — Dátum narodenia.
    - `place_of_birth` string — Miesto narodenia.
  - `match` 'exact' | 'prefix' | 'infix' — Spôsob vyhľadávania atribútov `corporate_body.name`, `natural_person.given_name` a `natural_person.family_name`.
  - `page` integer — Číslo stránky zoznamu identít.
  - `per_page` integer — Počet identít na stránke zoznamu.

## Response `200`

Úspešne vyhľadané identity podľa kritérií.

- union[]
  - union
    - UpvsCorporateBody — ÚPVS identita.
      - `ids` object[] — Sektorové identifikátory.
        - `type` string — Typ identifikátora.
        - `value` string, uuid — Hodnota identifikátora.
      - `uri` string, uri — URI identifikátor.
      - `en` string, en — Číslo eDesk schránky.
      - `type` 'natural_person' | 'legal_entity' | 'technical_account' | 'employee_of_public_administration' | 'institution_of_public_administration' — Typ: - `natural_person` fyzická osoba, - `legal_entity` právnická osoba, - `technical_account` technický účet, - `employee_of_public_administration` zamestnanec verejnej správy, - `institution_of_public_administration` orgán verejnej moci.
      - `status` 'registered' | 'activated' | 'verified' | 'blocked' | 'deactivated' — Stav: - `registered` registrovaný, - `activated` aktivovaný, - `verified` overený, - `blocked` blokovaný, - `deactivated` deaktivovaný.
      - `name` string — Názov alebo meno.
      - `suffix` string — Sufix.
      - `various_ids` object[] — Rôzne identifikátory.
        - `type` object — Hodnota podľa číselníka.
          - `id` string — Identifikátor hodnoty.
          - `name` string — Názov hodnoty.
          - `description` string — Popis hodnoty.
        - `value` string — Hodnota identifikátora.
        - `specified` boolean — Indikátor či ide o špecifikovaný identifikátor, ktorý bude nastavený.
      - `upvs` object — ÚPVS atribúty.
        - `edesk_number` string — Číslo eDesk schránky.
        - `edesk_status` 'nonexistent' | 'created' | 'active' | 'deliverable' | 'disabled' | 'deleted' — Stav eDesk schránky: - `nonexistent` neexistujúca schránka, - `created` vytvorená schránka (okrem prijímania správ), - `active` aktivovaná schránka (okrem prijímania doručeniek), - `deliverable` aktivovaná schránka na doručovanie (vrátane prijímania doručeniek), - `disabled` deaktivovaná schránka (okrem prijímania doručeniek), - `deleted` zrušená schránka.
        - `edesk_remote_uri` string, uri, nullable — URI adresa vzdialenej eDesk schránky.
        - `edesk_cuet_delivery_enabled` boolean — Indikátor či do eDesk schránky budú doručované CUET správy.
        - `edesk_delivery_limited` boolean — Indikátor či je doručovanie do eDesk schránky obmedzené.
        - `enotify_preferred_channel` 'email' | 'sms' — Preferovaný kanál prijímania správ.
        - `enotify_preferred_calendar` string — Preferovaný kalendár odosielania správ.
        - `enotify_emergency_allowed` boolean — Indikátor či je odosielanie núdzových správ povolené.
        - `enotify_email_allowed` boolean — Indikátor či je odosielanie e-mailov povolené.
        - `enotify_sms_allowed` boolean — Indikátor či je odosielanie SMS povolené.
        - `preferred_language` string — Preferovaný jazyk.
        - `re_iam_identity_id` string — Identifikátor v pôvodnom RE IAM.
      - `addresses` object[] — Fyzické adresy.
        - `type` 'resident' | 'contact' | 'post_office_box' | 'military' | 'undefined' — Typ adresy: - `resident` adresa trvalého pobytu alebo sídla, - `contact` kontaktná adresa, - `post_office_box` adresa poštovej schránky, - `military` vojenská adresa, - `undefined` nedefinovaná adresa.
        - `inline` string — Formátovaná adresa.
        - `country` object — Hodnota podľa číselníka.
          - `id` string — Identifikátor hodnoty.
          - `name` string — Názov hodnoty.
          - `description` string — Popis hodnoty.
        - `region` string — Kraj.
        - `district` object — Hodnota podľa číselníka.
          - `id` string — Identifikátor hodnoty.
          - `name` string — Názov hodnoty.
          - `description` string — Popis hodnoty.
        - `municipality` object — Hodnota podľa číselníka.
          - `id` string — Identifikátor hodnoty.
          - `name` string — Názov hodnoty.
          - `description` string — Popis hodnoty.
        - `part` string — Časť obce.
        - `street` string — Ulica.
        - `building_number` string — Orientačné číslo.
        - `registration_number` integer — Súpisné číslo.
        - `unit` string — Časť budovy.
        - `building_index` integer — Index budovy.
        - `delivery_address` object — Doručovacia adresa.
          - `postal_code` string — Poštové smerové číslo.
          - `post_office_box` string — Poštová schránka.
          - `recipient` object — Príjemca.
            - `corporate_body` object — Právnická osoba.
              - …
            - `natural_person` object — Fyzická osoba.
              - …
            - `note` string — Poznámka.
        - `ra_entry` string — Záznam v registri adries.
        - `specified` boolean — Indikátor či ide o špecifikovanú adresu, ktorá bude nastavená.
      - `emails` object[] — E-mailové adresy.
        - `address` string, email — Formátovaná adresa.
        - `dsig_key_info` string, base64 — DSig KeyInfo.
      - `phones` object[] — Telefónne čísla.
        - `type` object — Hodnota podľa číselníka.
          - `id` string — Identifikátor hodnoty.
          - `name` string — Názov hodnoty.
          - `description` string — Popis hodnoty.
        - `number` string, phone — Formátované číslo.
        - `international_country_code` string — Medzinárodné smerové číslo.
        - `national_number` string — Národné číslo.
        - `area_city_code` string — Smerové číslo.
        - `subscriber_number` string — Účastnícke číslo.
        - `extension` string — Sublinka.
    - UpvsNaturalPerson — ÚPVS identita.
      - `ids` object[] — Sektorové identifikátory.
        - `type` string — Typ identifikátora.
        - `value` string, uuid — Hodnota identifikátora.
      - `uri` string, uri — URI identifikátor.
      - `en` string, en — Číslo eDesk schránky.
      - `type` 'natural_person' | 'legal_entity' | 'technical_account' | 'employee_of_public_administration' | 'institution_of_public_administration' — Typ: - `natural_person` fyzická osoba, - `legal_entity` právnická osoba, - `technical_account` technický účet, - `employee_of_public_administration` zamestnanec verejnej správy, - `institution_of_public_administration` orgán verejnej moci.
      - `status` 'registered' | 'activated' | 'verified' | 'blocked' | 'deactivated' — Stav: - `registered` registrovaný, - `activated` aktivovaný, - `verified` overený, - `blocked` blokovaný, - `deactivated` deaktivovaný.
      - `name` string — Názov alebo meno.
      - `suffix` string — Sufix.
      - `various_ids` object[] — Rôzne identifikátory.
        - `type` object — Hodnota podľa číselníka.
          - `id` string — Identifikátor hodnoty.
          - `name` string — Názov hodnoty.
          - `description` string — Popis hodnoty.
        - `value` string — Hodnota identifikátora.
        - `specified` boolean — Indikátor či ide o špecifikovaný identifikátor, ktorý bude nastavený.
      - `upvs` object — ÚPVS atribúty.
        - `edesk_number` string — Číslo eDesk schránky.
        - `edesk_status` 'nonexistent' | 'created' | 'active' | 'deliverable' | 'disabled' | 'deleted' — Stav eDesk schránky: - `nonexistent` neexistujúca schránka, - `created` vytvorená schránka (okrem prijímania správ), - `active` aktivovaná schránka (okrem prijímania doručeniek), - `deliverable` aktivovaná schránka na doručovanie (vrátane prijímania doručeniek), - `disabled` deaktivovaná schránka (okrem prijímania doručeniek), - `deleted` zrušená schránka.
        - `edesk_remote_uri` string, uri, nullable — URI adresa vzdialenej eDesk schránky.
        - `edesk_cuet_delivery_enabled` boolean — Indikátor či do eDesk schránky budú doručované CUET správy.
        - `edesk_delivery_limited` boolean — Indikátor či je doručovanie do eDesk schránky obmedzené.
        - `enotify_preferred_channel` 'email' | 'sms' — Preferovaný kanál prijímania správ.
        - `enotify_preferred_calendar` string — Preferovaný kalendár odosielania správ.
        - `enotify_emergency_allowed` boolean — Indikátor či je odosielanie núdzových správ povolené.
        - `enotify_email_allowed` boolean — Indikátor či je odosielanie e-mailov povolené.
        - `enotify_sms_allowed` boolean — Indikátor či je odosielanie SMS povolené.
        - `preferred_language` string — Preferovaný jazyk.
        - `re_iam_identity_id` string — Identifikátor v pôvodnom RE IAM.
      - `addresses` object[] — Fyzické adresy.
        - `type` 'resident' | 'contact' | 'post_office_box' | 'military' | 'undefined' — Typ adresy: - `resident` adresa trvalého pobytu alebo sídla, - `contact` kontaktná adresa, - `post_office_box` adresa poštovej schránky, - `military` vojenská adresa, - `undefined` nedefinovaná adresa.
        - `inline` string — Formátovaná adresa.
        - `country` object — Hodnota podľa číselníka.
          - `id` string — Identifikátor hodnoty.
          - `name` string — Názov hodnoty.
          - `description` string — Popis hodnoty.
        - `region` string — Kraj.
        - `district` object — Hodnota podľa číselníka.
          - `id` string — Identifikátor hodnoty.
          - `name` string — Názov hodnoty.
          - `description` string — Popis hodnoty.
        - `municipality` object — Hodnota podľa číselníka.
          - `id` string — Identifikátor hodnoty.
          - `name` string — Názov hodnoty.
          - `description` string — Popis hodnoty.
        - `part` string — Časť obce.
        - `street` string — Ulica.
        - `building_number` string — Orientačné číslo.
        - `registration_number` integer — Súpisné číslo.
        - `unit` string — Časť budovy.
        - `building_index` integer — Index budovy.
        - `delivery_address` object — Doručovacia adresa.
          - `postal_code` string — Poštové smerové číslo.
          - `post_office_box` string — Poštová schránka.
          - `recipient` object — Príjemca.
            - `corporate_body` object — Právnická osoba.
              - …
            - `natural_person` object — Fyzická osoba.
              - …
            - `note` string — Poznámka.
        - `ra_entry` string — Záznam v registri adries.
        - `specified` boolean — Indikátor či ide o špecifikovanú adresu, ktorá bude nastavená.
      - `emails` object[] — E-mailové adresy.
        - `address` string, email — Formátovaná adresa.
        - `dsig_key_info` string, base64 — DSig KeyInfo.
      - `phones` object[] — Telefónne čísla.
        - `type` object — Hodnota podľa číselníka.
          - `id` string — Identifikátor hodnoty.
          - `name` string — Názov hodnoty.
          - `description` string — Popis hodnoty.
        - `number` string, phone — Formátované číslo.
        - `international_country_code` string — Medzinárodné smerové číslo.
        - `national_number` string — Národné číslo.
        - `area_city_code` string — Smerové číslo.
        - `subscriber_number` string — Účastnícke číslo.
        - `extension` string — Sublinka.

---

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