Validations
Get validations
POST
https://www.pepdata.com/api/get_validations
Endpoint to get validations.
Headers
Authorization*
string
key [API_KEY]
Request Body
page
number
Page of the validations. Default: 1
source
string
Source of the validations. Default: all Possible values:
all
upload
manual
status
string
Status of the validations. Default: all Possible values:
all
complete
complete_identified
complete_not_identified
needs_attention
incomplete
id
string
Id of the validation
id_custom
string
Custom id of the validation
sort_by
string
Property used for sorting validations Possible values:
added_at
determined_at
name
sort_dir
string
Descending or ascending sorting of validations Possible values:
desc
asc
{
"version": 0.1,
"timestamp": 1688640113263,
"data": {
"count": 2,
"total": 2,
"page": 1,
"max_results_per_page": 50,
"items": [
{
"id": "2a206d4a-0a5d-4a04-9a0c-cadae6e2cffa",
"vatin": "628579388",
"source": "Automatic",
"name": "John Marcus Smith",
"birth_date": "1986-01-08",
"id_country_nationality": "GBR",
"id_country_residence": null,
"decision": null,
"id_iperson": 9bbf3184-8ced-4095-9cad-7e4dc664c9ee,
"iperson_classifications": [
"PEP",
"Family Member",
"Associate"
],
"relations": [
{
"name": "António Silva",
"vatin": null,
"id_iperson": "5e809bc7-927e-3dc3-0ff8-ab9022843a5a",
"id_iorganization": null,
"relationship_type": "representative",
"id_relationship_info": "d0a4effc-576e-a4a2-f32e-9e594d7144ba"
}
],
"added_by": "cd9f4a64-ab25-4efb-bf31-323ee2280095",
"added_at": 1688639245750,
"determined_at": null,
"determined_by": null,
"identifiable_country": null,
"id_organization": "6cc1b6c1-33a9-4095-a4a4-aaca0db8d647",
"id_custom": null,
"entity_type": "individual",
"id_iorganization": null,
"adverse_media_searched_at": null,
"alerts": [],
"country_nationality": "United Kingdom"
},
{
"id": "a58dd84e-7e89-9904-5acf-2b1fbfcc8a31",
"vatin": "595596160",
"source": "Automatic",
"name": "Maria Edite Nieto",
"birth_date": null,
"id_country_nationality": "PT",
"id_country_residence": null,
"decision": null,
"id_iperson": null,
"iperson_classifications": null,
"relations": null,
"added_by": "cd9f4a64-ab25-4efb-bf31-323ee2280095",
"added_at": 1688639245750,
"determined_at": null,
"determined_by": null,
"identifiable_country": null,
"id_organization": "6cc1b6c1-33a9-4095-a4a4-aaca0db8d647",
"id_custom": null,
"entity_type": "individual",
"id_iorganization": null,
"adverse_media_searched_at": null,
"judicial_processes_searched_at": null,
"alerts": [
{
"id": "1d71c856-8dde-4815-9dce-1683e176a6f1",
"added_at": 1689244974065,
"resolved_by": null,
"resolved_at": null,
"reasons": [
"There is a new result that might match this validation: Mary Elizabeth Smith"
]
}
],
"country_nationality": "Portugal"
},
]
}
}
Label
id: validation id.
vatin: vat number of the validation.
source: validation source.
name: validation name.
birth_date: birth date of the validation.
id_country_nationality: code of the nationality country, in ISO 3166-1 alpha-2 format.
id_country_residence: code of the residence country, in ISO 3166-1 alpha-2 format.
decision: boolean that describes whether there was a match with an identifiable person.
id_iperson: id of the corresponding identifiable person. null if there is no match.
iperson_classifications: list of classifications of the identifiable person, possible values:
Asociate
Family Member
Holder of Other Political or Public Positions
PEP
Sanctioned (EU)
Sanctioned (HM Treasury)
Sanctioned (OFAC)
Sanctioned (UN)
relations: relationships where the validation is associated. It contains the following properties:
name: relationship name.
vatin: vat number of the relationship.
id_iperson: id of the identifiable person associated with the relationship.
id_iorganization: id of the identifiable organization associated with the relationship.
relationship_type: type of the relationship. Possible values:
representative
manager
beneficiary
beneficial_owner
id_relationship_info: id of the relationship.
added_by: id of the user who added the validation.
added_at: date the validation was added, as a number of milliseconds since January 1, 1970 00:00:00 UTC.
determined_at: date the validation was determined, as a number of milliseconds since January 1, 1970 00:00:00 UTC.
determined_by: id of the user who determined the validation.
identifiable_country: boolean that describes whether the country of the validation country is sanctioned.
id_organization: id of the organization who created the validation.
id_custom: customizable id entered by the user.
entity_type: type of validation that could be: "individual" or "organization".
id_iorganization: id of the correspondent identifiable organization. null in case there is no match.
adverse_media_searched_at: date of the last search of adverse media, associated with the validation name.
judicial_processes_searched_at: date of the last search of judicial processes associated with the validation name.
alerts: alerts related to the validation that are still unresolved.
country_nationality: nationality country.
Export validations
POST
https://www.pepdata.com/api/export_validations
Headers
Authorization*
string
key [API_KEY]
Request Body
from*
int
Start date of the filter, by the form of milliseconds number from 1st of January 1970 00:00:00 UTC.
until*
int
End date of the filter, by the form of milliseconds number from 1st of January 1970 00:00:00 UTC.
status
string
Status of the validations
Default: all
Possible values:
all
complete
complete_identified,
complete_not_identified
needs_attention
incomplete
format
string
Exported file format Default: xlsx Possible values:
xlsx
csv
export_by
string
Export validations by date of addition or date of determination. Default: added_at Possible values:
added_at
determined_at
timezone
string
Timezone of the timestamps used in the filters Default: Europe/Lisbon
Response
Obtain alerts of the validations
POST
https://www.pepdata.com/api/get_alerts
Headers
Authorization*
string
key [API_KEY]
Request Body
id_validation
string
id of the validation
ids_validation
string array
Array of the validations ids
status
string
Status of the alerts Default: unresolved Possible values:
all
resolved
unresolved
from
int
Start date of the filter, by the form of milliseconds number from 1st of January 1970 00:00:00 UTC.
until
int
End date of the filter, by the form of milliseconds number from 1st of January 1970 00:00:00 UTC.
page
number
Page of the alerts.
Default: 1
include_comments
boolean
Parameter to request information about the comments associated with the alerts.
Default: false
Possible values:
true
false
{
"data": {
"items": [
{
"id": "53fef9d4-e3d4-ed03-5e79-38ba066050f7",
"id_validation": "3462600c-8b9a-6384-c321-4587104ce0f1",
"name": "José Codinha Manso",
"birth_date": null,
"id_country_nationality": "JP",
"added_at": 1687873995707,
"resolved_at": null,
"resolved_by": null,
"status": "unresolved",
"reason": "Podem ter sido encontradas novas adverse media relativas a esta pessoa.",
"country_nationality": "Japan",
"comments": [
{
"id": "ff959c5f-8dbb-130c-f904-b0b02359d113",
"comment": "Comment 1"
},
{
"id": "2b0c4c70-6730-9056-b3c2-bb8dc21125d3",
"comment": "Comment 2"
}
]
}
],
"count": 1,
"total": 1,
"page": 1,
"max_results_per_page": 50
}
"version": "0.1",
"timestamp": 1588599744111
}
Label
id: id of the alert.
id_validation: id of the validation.
name: name of the identifiable person.
birth_date: birth date of the identifiable person.
id_country_nationality: code of the nationality country in the format ISO 3166-1 alpha-2.
added_at: date when the alert was generated, by the form of milliseconds number from 1st of January 1970 00:00:00 UTC.
resolved_at: date when the alert was resolved, by the form of milliseconds number from 1st of January 1970 00:00:00 UTC.
resolved_by: user that resolved the alert.
status: status of the alert.
reason: reason for creating the alert.
country_nationality: country of nationality.
comments: comments associated with the alert.
id: id of the comment.
comment: comment.
Add validation
POST
https://www.pepdata.com/api/add_validation
Endpoint to add a validation.
Headers
Authorization*
string
key [API_KEY]
Request Body
ignore_duplicates
boolean
Instruction to ignore the verification of duplicates.
Format: 0/1 Default: 0
name*
string
Name of the validation
birth_date
string
Birth date of the validation. Format: yyyy-mm-dd Default: null
country_nationality
string
Country of nationality of the validation.
Parameter used only in individual validations. Format: Name of the country (see note bellow) Default: null
id_custom
string
Custom Id of the validation.
Default: null
country_residence
string
Country of residence of the validation.
Parameter used only in person validations.
Format: Name of the country (see note bellow)
Default: null
vatin
string
Vat number of the validation
Default: null
type
string
Type of entity, that could be: "individual" or "organization"
Default: "individual"
country
string
Country of the validation.
Parameter used only in organizations validations.
Format: Name of the country (see note bellow)
Default: null
{
"data": {
"id": "926b7dab-a3af-986f-2137-872adb95260f"
},
"version": "0.1",
"timestamp": 1588599744111
}
Label
id: id od the created validation.
Analyze validation
POST
https://www.pepdata.com/api/analyze_validation
Endpoint to consult the results obtained from the analysis of a validation.
Headers
Authorization*
string
key [API_KEY]
Request Body
id
string
Id of the validation
include_iperson_details
boolean
Include information about the classifications, occupations and relationships of the identifiable persons. Format: true/false Default: false
{
"data": {
"items": [
{
"id": "0bdeb685-8d0b-41ec-a3ff-996188fe2b22",
"name": "João Pedro Silva",
"birth_date": null,
"score": 95
"classifications": [
"PEP"
],
"occupations": [
{
"organization": "Governo da República Portuguesa",
"organ": "Ministério dos Negócios Estrangeiros",
"position": "Ministro",
"source": "https://test-link.com",
"start_date": null,
"end_date": null,
"comments": null
}
],
"relationships": []
},
{
"id": "BFFD688C-4618-048D-9C14-8887B1BDA173",
"name": "John Frederik White",
"birth_date": "1933-05-25",
"score": 76,
"classifications": [
"PEP",
"Family Member"
],
"occupations": [
{
"organization": "Government of the United Kingdom",
"organ": "Ministry of Justice",
"position": "Minister",
"source": "https://test-link.com",
"start_date": "2005-01-01",
"end_date": "2030-01-01",
"comments": null
}
],
"relationships": [
{
"relationship_type": "son",
"relationship_to": "Harry Charles White",
"source": "https://test-link.com",
"end_date": null,
"comments": null
},
{
"relationship_type": "spouse",
"relationship_to": "Jane Anne White",
"source": "https://test-link.com",
"end_date": null,
"comments": null
}
]
}
],
"count": 2
},
"version": "0.1",
"timestamp": 1588599744111
}
Label
id: id of the identifiable person.
name: name of the identifiable person.
birth_date: date of birth of the identifiable person.
score: degree of similarity.
classifications: classifications of the identifiable person.
occupations: list of occupations of the identifiable person:
organization: occupation organization .
organ: occupation organ.
position: position in occupation.
source: source link that relates the identifiable person to the occupation.
start_date: occupation start date.
end_date: occupation end date.
comments: relevant notes about the occupation.
relationships: list of relationships of the identifiable person.
relationship_type: type of relationship.
relationship_to: name of the identifiable person's family member.
source: source link with information about the relationship.
end_date: end date of the relationship.
comments: relevant notes about the relationship.
Validation determination
POST
https://www.pepdata.com/api/determine_validation
Endpoint to determine a validation.
Headers
Authorization*
string
key [API_KEY]
Request Body
id
string
Id of the validation
id_entity
string
Id of the corresponding identifiable person or organization.
{
"version": 0.1,
"timestamp": 1695805850051,
"data": {
"message": "The validation was successfully determined."
}
}
Delete validation
POST
https://www.pepdata.com/api/delete_validation
Endpoint to delete a validation.
Headers
Authorization*
string
key [API_KEY]
Request Body
id
string
Id of the validation
{
"version": 0.1,
"timestamp": 1695806667520,
"data": {
"message": "The validation was successfully deleted."
}
}
Apply rules
POST
https://www.pepdata.com/api/apply_rules
Endpoint for applying validation rules.
Headers
Authorization*
string
key [API_KEY]
{
"version": 0.1,
"timestamp": 1695983552463,
"data": {
"time_to_conclusion": 1
}
}
Label
time_to_conclusion: estimated time in seconds for the operation to complete.
Obtain comments
POST
https://www.pepdata.com/api/get_comments
Endpoint to obtain comments.
Headers
Authorization*
string
key [API_KEY]
Request Body
page
number
Page of the comments.
Default: 1
type
string
Type of the comments.
Possible values:
determination
alert
judicial_process
adverse_media
id_validation
string
Id of the validation associated with the comments.
{
"version": 0.1,
"timestamp": 1697728294225,
"data": {
"count": 2,
"total": 2,
"items": [
{
"id": "ff959c5f-8dbb-130c-f904-b0b02359d113",
"comment": "Comentário 1",
"added_at": 1697704218743,
"added_by": "António Jesus",
"id_validation": "a086cf5f-99ad-12d6-7a80-3d9a47a638d0",
"id_iperson": null,
"id_validation_alert": "e9b629b3-0566-c119-1de3-a86d8436205d",
"id_validation_judicial_process": null,
"id_validation_adverse_media": null,
"id_added_by": "cd9f4a64-ab25-4efb-bf31-323ee2280095"
},
{
"id": "12cdbdba-685d-73d5-fc35-017ecb17c166",
"comment": "Comentário 2",
"added_at": 1697704304926,
"added_by": "António Jesus",
"id_validation": "6f95d22f-9751-3d02-0784-0c6288c79c66",
"id_iperson": "91a1d1c0-bfd0-6e4b-3574-08c40bc9e577",
"id_validation_alert": null,
"id_validation_judicial_process": null,
"id_validation_adverse_media": null,
"id_added_by": "cd9f4a64-ab25-4efb-bf31-323ee2280095"
}
],
"page": 1,
"max_results_per_page": 50
}
}
Label
id: id of the comment.
comment: comment.
added_at: date when the comment was added, by the form of milliseconds number from 1st of January 1970 00:00:00 UTC.
added_by: user responsible for adding the comment.
id_validation: id of the validation associated with the comment.
id_iperson: id of the corresponding identifiable person, if the type of the comment is "determination".
id_validation_alert: id of the correspondig validation alert, if the type of the comment is "alert".
id_validation_judicial_process: id of the corresponding judicial process, if the type of the comment is "judicial_process".
id_validation_adverse_media: id of the corresponding adverse media, if the type of the comment is "adverse_media".
id_added_by: id of the user responsible for adding the comment.
Add a comment
POST
https://www.pepdata.com/api/add_comment
Endpoint for adding a comment
Headers
Authorization*
string
key [API_KEY]
Request Body
id_validation*
string
Id of the validation
id_iperson
string
Id of the corresponding identifiable person. This parameter is mandatory if the comment to be added refers to the identification of a validation.
comment*
string
Comment
id_validation_alert
string
Id of the corresponding validation alert. This parameter is mandatory if the comment to be added refers to a validation alert.
id_validation_judicial_process
string
Id of the corresponding judicial process. This parameter is mandatory if the comment to be added refers to a judicial process.
id_validation_adverse_media
string
Id of the corresponding adverse news. This parameter is mandatory if the comment to be added refers to adverse news.
{
"version": 0.1,
"timestamp": 1697730099564,
"data": {
"id": "ac33a772-a869-1c36-8569-5cba9cd0542d"
}
}
Label
id: id of the new comment.
Edit a comment
POST
https://www.pepdata.com/api/edit_comment
Endpoint to edit a comment.
Headers
Authorization*
string
key [API_KEY]
Request Body
id*
string
Id of the comment to be edited
comment*
string
Comment
{
"version": 0.1,
"timestamp": 1697730574961,
"data": {
"message": "Comment successfully edited."
}
}
Delete a comment
POST
https://www.pepdata.com/api/delete_comment
Endpoint to delete a comment.
Headers
Authorization*
string
key [API_KEY]
Request Body
id*
string
Id of the comment to be deleted
{
"version": 0.1,
"timestamp": 1697730574961,
"data": {
"message": "Comment successfully deleted."
}
}
Obtain relationships of a certain validation
POST
https://www.pepdata.com/api/get_validation_relationships
Endpoint to obtain relationships of a certain validation.
Headers
Authorization*
string
key [API_KEY]
Request Body
id_validation*
string
Id of the validation
page
number
Page of the relationships.
Default: 1
{
"version": 0.1,
"timestamp": 1697795044035,
"data": {
"items": [
{
"id": "7f0c97de-6c71-1461-4d9b-da65b4670824",
"id_relationship": "a86a80bf-0d90-cdfe-1869-726b898cc426",
"relationship_type": "representative",
"relationship_to": "António João Soares",
"id_relationship_to": "df3250ff-382f-c9aa-346e-ef76dd3d333f",
"id_relationship_from": "6474d5fc-205a-f750-2dd6-24c5d87a5ee5",
"added_by": "Carlos Araujo",
"added_at": 1697795029624
},
{
"id": "3b402dbb-ccef-c773-7fac-3225ce7f0e25",
"id_relationship": "7c5d3c73-b61c-44ae-6d0a-234e1ea2145b",
"relationship_type": "manager",
"relationship_to": "José Manuel Silva",
"id_relationship_to": "3b981423-e1eb-f30f-b4ff-d72b8f34c43a",
"id_relationship_from": "6474d5fc-205a-f750-2dd6-24c5d87a5ee5",
"added_by": "Carlos Araujo",
"added_at": 1697795038487
}
],
"count": 2,
"total": 2,
"page": 1,
"max_results_per_page": 50
}
}
Legenda
id: relationship information table identifier.
id_relationship: id of the relationship.
relationship_type: type of the relationship.
relationship_to: name of the validation for which the relationship was created.
id_relationship_to: id of the validation for which the relationship was created.
id_relationship_from: id of the validation from which the relationship was created.
added_by: user responsible for creating the relationship.
added_at: date when the relationship was added, by the form of milliseconds number from 1st of January 1970 00:00:00 UTC.
Add a validation relationship.
POST
https://www.pepdata.com/api/add_validation_relationship
Endpoint to add a validation relationship.
Headers
Authorization*
string
key [API_KEY]
Request Body
organization_vat_number*
string
Vat number of the validation from which the relationship will be created. It must be an organization validation.
vat_number*
string
Vat number of the validation to which the relationship will be created. It must be a person validation if the relationship type is representative, manager or beneficial_owner.
position_in_organization*
string
Type of the relationship.
Possible values:
representative
manager
owner
beneficial_owner
{
"version": 0.1,
"timestamp": 1697798272664,
"data": {
"id": "8e6c7899-7c13-33d1-0538-50faf20f123e"
}
}
Legenda
id: id of the new relationship.
Edit a validation relationship
POST
https://www.pepdata.com/api/edit_validation_relationship
Endpoint to edit a validation relationship
Headers
Authorization*
string
key [API_KEY]
Request Body
id_relationship_info*
string
Relationship information table identifier associated with the relationship to be edited.
position_in_organization*
string
Tipo of relationship.
Possible values:
representative
manager
owner
beneficial_owner
{
"version": 0.1,
"timestamp": 1697798682365,
"data": {
"message": "Relationship successfully edited."
}
}
Delete a validation relationship
POST
https://www.pepdata.com/api/delete_validation_relationship
Endpoint to delete a validation relationship.
Headers
Authorization*
string
key [API_KEY]
Request Body
id_relationship_info*
string
Relationship information table identifier associated with the relationship to be deleted.
{
"version": 0.1,
"timestamp": 1697798682365,
"data": {
"message": "Relationship successfully deleted."
}
}
Last updated
Was this helpful?