Verifying entity information
Verify entity, or company, data against registries and commercial data sources.
With database verification, you only need to use this endpoint. Entities are created and submitted for processing automatically.
Make sure you pass the correct country
when calling this endpoint. This tells us the relevant registry and sources to check within the country.
Verify identity data
POST
/api-entity-database-verification
Create the entity, match and verify the entity data, and request verification.
Body
Name | Type | Description |
---|
| | The name of the flow your Account Manager has provided (required) |
| | The entity's legal name (required) |
| | The entity's registration number (required) |
| | The entity's registration country, in alpha-3 format (required) |
Use ISO 3166-1 A3 format forcountry.
See here for country codes.
Request
curl --location 'https://enterprise.personr.co/api/1.1/wf/api-entity-database-verification' \
--form 'flowName="KYB Basic"' \
--form 'companyName="Personr Pty Ltd"' \
--form 'registrationNumber="123456789"' \
--form 'country="AUS"'
var axios = require('axios');
var FormData = require('form-data');
var data = new FormData();
data.append('flowName', 'KYB Basic');
data.append('companyName', 'Personr Pty Ltd');
data.append('registrationNumber', '123456789');
data.append('country', 'AUS');
var config = {
method: 'post',
maxBodyLength: Infinity,
url: 'https://enterprise.personr.co/api/1.1/wf/api-entity-database-verification',
headers: {
...data.getHeaders()
},
data : data
};
axios(config)
.then(function (response) {
console.log(JSON.stringify(response.data));
})
.catch(function (error) {
console.log(error);
});
var form = new FormData();
form.append('flowName', 'KYB Basic');
form.append('companyName', 'Personr Pty Ltd');
form.append('registrationNumber', '123456789');
form.append('country', 'AUS');
var settings = {
"url": "https://enterprise.personr.co/api/1.1/wf/api-entity-database-verification",
"method": "POST",
"timeout": 0,
"processData": false,
"mimeType": "multipart/form-data",
"contentType": false,
"data": form
};
$.ajax(settings).done(function (response) {
console.log(response);
}).fail(function (error) {
console.error(error);
});
require "uri"
require "net/http"
url = URI("https://enterprise.personr.co/api/1.1/wf/api-entity-database-verification")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Post.new(url)
form_data = [
['flowName', 'KYB Basic'],
['companyName', 'Personr Pty Ltd'],
['registrationNumber', '123456789'],
['country', 'AUS']
]
request.set_form form_data, 'multipart/form-data'
response = https.request(request)
puts response.read_body
import requests
url = "https://enterprise.personr.co/api/1.1/wf/api-entity-database-verification"
payload = {
'flowName': 'KYB Basic',
'companyName': 'Personr Pty Ltd',
'registrationNumber': '123456789',
'country': 'AUS'
}
response = requests.post(url, data=payload)
print(response.text)
Response
{
"status": "success",
"response": {
"applicantId": "4242424242424242x42424242424242",
"flow": "KYB Basic",
"status": "Pending"
}
}
{
"statusCode": 400,
"message": "Error: incorrect flowName provided"
}
Last updated