Sign in

v1

latestOpenAPI 3.1.02026-07-241695611.0 MB
PEP

Search Pep

Search for Politically Exposed Persons (PEP) matches by name.

post/pep/searches

Request body

namestring required

The name to search for in the PEP database

similarity_thresholdnumber

Similarity threshold for the search (0.0 to 1.0). Defaults to 0.9.

limitinteger

The number of results to return. Max 50. Defaults to 1.

Response

Successful Response

total_matchesinteger required

The total number of PEP matches.

Example response

{
  "matches": [
    {
      "name": "John Doe",
      "alternative_names": [
        "Johnny D.",
        "Acme Inc."
      ],
      "addresses": [
        "123 Main St, Anytown",
        "456 Business Ave, Metropolis"
      ],
      "similarity_score": 0.9,
      "date_of_birth": "1980-01-15",
      "first_name": "John",
      "middle_name": "Fitzgerald",
      "last_name": "Doe",
      "title": "Dr.",
      "classification": "National government (current)",
      "political_party": "Independent",
      "birth_place": "Springfield, Illinois",
      "death_date": "2021-06-04",
      "wikidata_id": "Q7747",
      "positions": [
        {
          "name": "Member of the National Assembly",
          "subnational_area": "California",
          "categories": [
            "GOVERNMENT_LEGISLATIVE",
            "GOVERNMENT_NATIONAL"
          ],
          "start_date": "2019-05-20",
          "end_date": "2023-01-31"
        }
      ],
      "risks": [
        "GOVERNMENT_EXECUTIVE",
        "GOVERNMENT_FINANCIAL"
      ],
      "associated_countries": [
        "US",
        "GB"
      ],
      "emails": [
        "john.doe@example.com"
      ],
      "phone_numbers": [
        "+1-215-555-1234"
      ],
      "websites": [
        "https://www.acme.com"
      ],
      "source_links": [
        "https://news.example.com/article/123"
      ]
    }
  ],
  "total_matches": 1
}