Public
Documentation Settings
No Environment
Double Column
cURL - cURL
pepcheck.cz
Introduction
GET
/search/external

pepcheck.cz

Externí API pro službu PEP check – nejrychlejší způsob, jak nalézt české politicky exponované osoby na jednom místě.

GET/search/external

https://api.pepcheck.cz/search/external?token=TOKEN&name=NAME&birth_date=BIRTH_DATE

Vyhledávací dotaz je nutné posílat jako typ GET s definovanými třemi parametry: token, name a birth_date. Dále je nezbytné, aby požadavek obsahoval hlavičku Authorization s hodnotou Bearer secret.

Úspěšná odpověď z API tedy 200 OK může nabývat těchto stavů v parametru "status": POTENTIAL_MATCH, MATCH a OK.

V případě POTENTIAL_MATCH bude detail vyhledávání v poli potential_matches. Naproti tomu v případě MATCH bude detail vyhledávání v poli exact_matches.

V obou případech, tzn. shody i částečné shody je k dispozici PDF dokument, jako potvrzení vyhledávání s možností stažení. API vrací HASH tohoto PDF v parametru "pdf". Adresa pro stažení PDF je pak následující: https://api.pepcheck.cz/search/HASH/pdf. Toto PDF potvrzení je bez zdrojů vyhledávání.

Mezinárodní vyhledávání

Výsledky mezinárodního vyhledávání naleznete v parametru international ve stejné struktuře, tedy potential_matches v případě částečné shody a exact_matches v případně shody.

API DEV

Pokud máte zájem o otestování implementace ve svém systému, stačí udělat registraci na adrese https://dev.pepcheck.cz a zažádat o přidělení přístupu skrze email podpora@pepcheck.cz. Automaticky tak dostanete pro Vaše testování 50 kreditů zdarma a můžete si vše bezplatně vyzkoušet.

URL DEV API je: https://api-dev.pepcheck.cz

VAROVÁNÍ
Data v DEV verzi nemusejí a ani nejsou aktuální a úplná, proto prosím DEV nikdy nevyužívejte pro účely ověřování.

AUTHORIZATIONBearer Token
Token

<token>

PARAMS
token

TOKEN

name

NAME

birth_date

BIRTH_DATE

Example Request
200 OK
curl
curl --location 'https://api.pepcheck.cz/search/external?token=TOKEN&name=Milo%C5%A1%20Zeman&birth_date=1944-09-28' \
--data ''
200 OK
Example Response
json
{
  "exact_matches": [
    {
      "birth_date": "Thu, 28 Sep 1944 00:00:00 GMT",
      "changed": null,
      "changed_by": null,
      "created": "Wed, 05 Apr 2023 21:53:31 GMT",
      "created_by": null,
      "full_name": "Ing. Miloš Zeman, dr. h. c.",
      "functions": [
        {
          "id": 20302,
          "name": "Prezident republiky ČR",
          "since": "Fri, 08 Mar 2013 00:00:00 GMT",
          "until": "Wed, 08 Mar 2023 00:00:00 GMT"
        },
        {
          "id": 20303,
          "name": "Předseda ČSSD",
          "since": "Sun, 28 Feb 1993 00:00:00 GMT",
          "until": "Sat, 07 Apr 2001 00:00:00 GMT"
        },
        {
          "id": 20304,
          "name": "Předseda strany Práv Občanů ZEMANOVCI (SPOZ)",
          "since": "Sat, 06 Mar 2010 00:00:00 GMT",
          "until": "Sat, 29 May 2010 00:00:00 GMT"
        },
        {
          "id": 20305,
          "name": "Poslanec Poslanecké sněmovny PČR",
          "since": "Sat, 01 Jun 1996 00:00:00 GMT",
          "until": "Thu, 20 Jun 2002 00:00:00 GMT"
        },
        {
          "id": 20306,
          "name": "Předseda vlády ČR",
          "since": "Fri, 17 Jul 1998 00:00:00 GMT",
          "until": "Mon, 15 Jul 2002 00:00:00 GMT"
        }
      ],
      "id": 1929,
      "image": "https://upload.wikimedia.org/wikipedia/commons/thumb/7/7d/Prezident_Zeman_MSV.jpg/220px-Prezident_Zeman_MSV.jpg",
      "sources": [
        "https://en.wikipedia.org/wiki/Milo%C5%A1_Zeman",
        "https://cs.wikipedia.org/wiki/Seznam_premi%C3%A9r%C5%AF_%C4%8Ceska",
        "https://www.hrad.cz/cs/prezident-cr/prezidenti-v-minulosti/milos-zeman",
        "https://www.psp.cz/sqw/detail.sqw?id=253&o=9",
        "https://www.psp.cz/sqw/detail.sqw?id=253&o=2",
        "https://www.psp.cz/sqw/detail.sqw?id=253&o=3",
        "https://aplikace.mvcr.cz/seznam-politickych-stran/Vypis_Historie.aspx?id=324&typ=0"
      ]
    }
  ],
  "id": 58125,
  "international": {
    "exact_matches": [
      {
        "alias_names": [
          "Milos Zeman"
        ],
        "children": [
          "David Zeman",
          "Kateřina Zemanová"
        ],
        "citizenship": [
          "CZ"
        ],
        "date_of_birth": "Thu, 28 Sep 1944 00:00:00 GMT",
        "description": [
          "Former president of the Czech Republic (2013–2023) and a politician"
        ],
        "entity_type": "INDIVIDUAL",
        "gender": "MALE",
        "given_names": [
          "Miloš"
        ],
        "last_names": [
          "Zeman"
        ],
        "links": [
          "https://www.kancelarmilosezemana.cz",
          "http://www.zemanmilos.cz",
          "Facebook: prezidentcr"
        ],
        "list_date": "0",
        "name": "Miloš Zeman",
        "occupations": [
          "economist",
          "politician"
        ],
        "parents": [
          "Josef Zeman",
          "Marie Zemanová"
        ],
        "pep_type": "POLITICIAN",
        "place_of_birth": [
          "Kolín"
        ],
        "political_parties": [
          "Civic Forum",
          "Communist Party of Czechoslovakia",
          "Czech Social Democratic Party",
          "Občanské hnutí",
          "Party of Civic Rights"
        ],
        "positions": [
          "1990-01-30 - 1992-12-31  member of the Federal Assembly of Czechoslovakia",
          "2010-03-06 - 2010-05-29  party leader",
          "1996-06-01 - 1998-06-19  Member of the Chamber of Deputies of the Parliament of the Czech Republic",
          "1998-06-20 - 2002-06-20  Member of the Chamber of Deputies of the Parliament of the Czech Republic",
          "1998-07-17 - 2002-07-15  Prime Minister of the Czech Republic",
          "1993-02-28 - 2001-04-07  party leader",
          "1996-06-27 - 1998-06-15  Chair of the Chamber of Deputies of the Parliament of the Czech Republic",
          "2013-03-08 - 2023-03-08  President of the Czech Republic"
        ],
        "source_id": "dilisense_pep",
        "source_type": "PEP",
        "spouse": [
          "Ivana Zemanová"
        ]
      }
    ],
    "found_records": [
      {
        "alias_names": [
          "Milos Zeman"
        ],
        "children": [
          "David Zeman",
          "Kateřina Zemanová"
        ],
        "citizenship": [
          "CZ"
        ],
        "date_of_birth": "Thu, 28 Sep 1944 00:00:00 GMT",
        "description": [
          "Former president of the Czech Republic (2013–2023) and a politician"
        ],
        "entity_type": "INDIVIDUAL",
        "gender": "MALE",
        "given_names": [
          "Miloš"
        ],
        "last_names": [
          "Zeman"
        ],
        "links": [
          "https://www.kancelarmilosezemana.cz",
          "http://www.zemanmilos.cz",
          "Facebook: prezidentcr"
        ],
        "list_date": "0",
        "name": "Miloš Zeman",
        "occupations": [
          "economist",
          "politician"
        ],
        "parents": [
          "Josef Zeman",
          "Marie Zemanová"
        ],
        "pep_type": "POLITICIAN",
        "place_of_birth": [
          "Kolín"
        ],
        "political_parties": [
          "Civic Forum",
          "Communist Party of Czechoslovakia",
          "Czech Social Democratic Party",
          "Občanské hnutí",
          "Party of Civic Rights"
        ],
        "positions": [
          "1990-01-30 - 1992-12-31  member of the Federal Assembly of Czechoslovakia",
          "2010-03-06 - 2010-05-29  party leader",
          "1996-06-01 - 1998-06-19  Member of the Chamber of Deputies of the Parliament of the Czech Republic",
          "1998-06-20 - 2002-06-20  Member of the Chamber of Deputies of the Parliament of the Czech Republic",
          "1998-07-17 - 2002-07-15  Prime Minister of the Czech Republic",
          "1993-02-28 - 2001-04-07  party leader",
          "1996-06-27 - 1998-06-15  Chair of the Chamber of Deputies of the Parliament of the Czech Republic",
          "2013-03-08 - 2023-03-08  President of the Czech Republic"
        ],
        "source_id": "dilisense_pep",
        "source_type": "PEP",
        "spouse": [
          "Ivana Zemanová"
        ]
      }
    ],
    "potential_matches": [],
    "status": "MATCH",
    "timestamp": "2025-01-24T10:41:39Z",
    "total_hits": 1
  },
  "objectID": 58125,
  "pdf": "QRXDtXzJWkTqWe7BXPLAH_Qptnhy8A",
  "pdf_sources": "QRXDtXzJWkTqWe7BXPLAH_Qptnhy8A",
  "potential_matches": [],
  "query": {
    "birth_date": "Thu, 28 Sep 1944 00:00:00 GMT",
    "name": "Miloš Zeman"
  },
  "sanctions": [],
  "status": "MATCH"
}
Content-Type

application/json

X-Cloud-Trace-Context

00439af16fd5714f1eb268c70909d966;o=1

Date

Wed, 08 Feb 2023 11:17:33 GMT

Server

Google Frontend

Content-Length

74368

Alt-Svc

h3=":443"; ma=2592000,h3-29=":443"; ma=2592000,h3-Q050=":443"; ma=2592000,h3-Q046=":443"; ma=2592000,h3-Q043=":443"; ma=2592000,quic=":443"; ma=2592000; v="46,43"