--- 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` ## Request - Base URL: `https://fix.slovensko-sk-api.staging.slovensko.digital` - URL: `https://fix.slovensko-sk-api.staging.slovensko.digital/api/iam/identities/search` - Auth: HTTP bearer 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. ## Changes - **2023-07-20** `a67c2ca5a496`: 1 breaking - the request property `address/type` became required - **2023-02-12** `2d20c9f74d08`: 1 breaking, 3 warning, 6 info - removed the enum value `corporate_body` of the request property `type` - removed the request property `corporate_body` - added the new `legal_entity` enum value to the `items/oneOf[#/components/schemas/UpvsCorporateBody]/allOf[#/components/schemas/UpvsIdentity]/type` response property for the response status `200` - added the new `legal_entity` enum value to the `items/oneOf[#/components/schemas/UpvsNaturalPerson]/allOf[#/components/schemas/UpvsIdentity]/type` response property for the response status `200` - …6 more - **2022-04-06** `8e6e38e83211`: 2 breaking - the response property `items/oneOf[#/components/schemas/UpvsCorporateBody]/allOf[#/components/schemas/UpvsIdentity]/upvs/edesk_remote_uri` became nullable for the status `200` - the response property `items/oneOf[#/components/schemas/UpvsNaturalPerson]/allOf[#/components/schemas/UpvsIdentity]/upvs/edesk_remote_uri` became nullable for the status `200` - **2021-02-06** `8b1f020bc0da`: 3 info - the endpoint scheme security `API + OBO Token` was removed from the API - api tag `Vyhľadávanie identít (dostupné len pre OVM)` added - api tag `Vyhľadávanie identít (len OVM)` removed - **2021-01-22** `39464695fc7b`: 1 info - endpoint added [Operation history](https://skmtc.dev/slovensko-digital/apis/slovensko-sk-api/changes/api/iam/identities/search/post.md) --- [API](https://skmtc.dev/slovensko-digital/apis/slovensko-sk-api.md) - [All operations](https://skmtc.dev/slovensko-digital/apis/slovensko-sk-api/llms.txt) - [OpenAPI document](https://skmtc.dev/slovensko-digital/apis/slovensko-sk-api/revisions/e8ab6a2875b7?raw)