Search

Identifiable person search

POST https://www.pepdata.com/api/search_iperson

Endpoint to search for an identifiable person.

Headers

Name	Type	Description
Authorization*	string	key [API_KEY]

Request Body

Name	Type	Description
name*	string	Name of the person to search
birth_date	string	Date of birth of the validation. Format: yyyy-mm-dd Default: null

200: OK Search performed successfully.

{
    "data": {
        "items": [
            {
              "id": "0bdeb685-8d0b-41ec-a3ff-996188fe2b22",
              "name": "António Belo de Castro Costa",
              "birth_date": null,
              "death_date": null,
              "id_country": "PT",
              "score": 95,
              "country": "Portugal"
            },
            {
              "id": "d7c48e2d-8699-4064-b94c-d6e2106fdf85",
              "name": "João Pedro Pereira",
              "birth_date": "1933-05-25",
              "death_date": null,
              "id_country": "PT",
              "score": 76,
              "country": "Portugal"
            }
        ]
    },
    "version": "0.1",
    "timestamp": 1588599744111
}

400: Bad Request Invalid name

{
    "message": {
        "version": 0.1,
        "timestamp": 1697030044748,
        "message": "Name is invalid. Please provide a name:  • With only Latin characters, apostrophes, spaces, dots or hyphens;"
    }
}

Label

• id: id of the identifiable person.

• name: name of the identifiable person.

• birth_date: birth date of the identifiable person.

• death_date: date of death of the identifiable person.

• id_country: primary country of the identifiable person, in ISO 3166-1 alpha-2 format.

• source: source of sanctions list, if any: EU, OFAC, HMTreasury or UN.

• score: degree of similarity.

• country: primary country of the identifiable person

Search for sanctioned organizations

POST https://www.pepdata.com/api/search_organization

Endpoint to search for a sanctioned organization.

Headers

Name	Type	Description
Authorization*	string	key [API_KEY]

Request Body

Name	Type	Description
name*	string	Organization name to search

200: OK Search performed successfully.

{
    "data": {
        "items": [
            {
                "id": "894e61ca-0264-0ed2-542c-d5aa53ef407c",
                "name": "Fekete Szeptember",
                "score": 100
            }
        ]
    },
    "version": "0.1",
    "timestamp": 1588599744111
}

400: Bad Request Name not found

{
    "message": {
        "version": 0.1,
        "timestamp": 1697030523249,
        "message": "Please enter the name to be searched."
    }
}

Label

• id: id of the sanctioned organization.

• name: name of the sanctioned organization.

• score: degree of similarity.

This endpoint performs a search on organizations on the following international sanctions lists:

• United Nations Security Council Consolidated List

• EU Financial Sanctions Database

• OFAC Specially Designated Nationals and Blocked Persons List

• HM Treasury Financial Sanctions Targets

Important: at the moment, the name of the organization must match the name on the sanctions list in order for results to be returned.

Get entities search report

POST https://www.pepdata.com/api/get_entities_search_report

Headers

Name	Type	Description
Authorization*	string	key [API_KEY]

Request Body

Name	Type	Description
name*	string	Entity name to search

Response

200: OK Report generated successfully

110KB

PEPData - Entities Search Report - António Silva.pdf

pdf

Entities search report example

400: Bad Request Name not found

{
    "message": {
        "version": 0.1,
        "timestamp": 1728489803845,
        "message": "Please enter a name."
    }
}