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
Label
id: validation id.
vatin: vat number of the validation.
source: validation source.
name: validation name.
birth_date: birth date of the validation.
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
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.
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
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
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.
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
Apply rules
POST
https://www.pepdata.com/api/apply_rules
Endpoint for applying validation rules.
Headers
Authorization*
string
key [API_KEY]
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.
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.
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
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
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
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
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
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.
Last updated
Was this helpful?