Sign in

v1

latestOpenAPI 3.0.02026-07-174129189.4 KB
Vyhľadávanie identít (dostupné len pre OVM)

Vráti identitu podľa osobných údajov alebo IČO

Vráti identitu na základe osobných údajov alebo IČO.

Možné spôsoby vyhľadávania:

  • IČO (company_registration_number) samostatne, alebo
  • Všetky tri parametre spoločne: rodné číslo (personal_identification_number), krstné meno (given_name) a priezvisko (family_name)

Pozor, volanie je dostupné len pre OVM.

get/api/iam/identities/lookup

Query parameters

personal_identification_numberstring
Example:1234567890

Rodné číslo fyzickej osoby. Vyžadované spolu s given_name a family_name, ak nie je poskytnuté company_registration_number.

given_namestring
Example:Ján

Krstné meno fyzickej osoby. Vyžadované spolu s personal_identification_number a family_name, ak nie je poskytnuté company_registration_number.

family_namestring
Example:Novák

Priezvisko fyzickej osoby. Vyžadované spolu s personal_identification_number a given_name, ak nie je poskytnuté company_registration_number.

company_registration_numberstring
Example:12345678

IČO právnickej osoby. Môže byť použité samostatne na vyhľadávanie.

Response

Úspešne vrátená identita.

OR

Example response

{
  "ids": [
    {
      "type": "sector_upvs",
      "value": "48e1fe89-ad95-46cf-b33a-5ddb76aea775"
    }
  ],
  "uri": "ico://sk/42156424",
  "type": "institution_of_public_administration",
  "status": "activated",
  "name": "Národná agentúra pre sieťové a elektronické služby",
  "various_ids": [
    {
      "type": {
        "id": 7,
        "name": "IČO (Identifikačné číslo organizácie)",
        "description": null
      },
      "specified": true
    }
  ],
  "upvs": {
    "edesk_status": "deliverable",
    "preferred_language": "sk"
  },
  "addresses": [
    {
      "type": "resident",
      "country": {
        "id": 0,
        "name": "Slovensko",
        "description": null
      },
      "municipality": {
        "id": 0,
        "name": "Trnava ",
        "description": null
      },
      "street": "Kollárova",
      "delivery_address": {
        "postal_code": 91702,
        "post_office_box": null,
        "recipient": null
      },
      "specified": true
    }
  ],
  "emails": [
    {
      "address": "mailto:test2012upvs@gmail.com"
    }
  ],
  "phones": [
    {
      "type": {
        "id": 1,
        "name": "Pevná sieť",
        "description": null
      }
    }
  ]
}