Name validation API
The name validation API validates whether a submitted name has a plausible personal-name format and checks the full value plus each individual name part against the active blocked-term database. It does not perform sanctions screening or prove identity.
Send either a single
Send either a single
full_name value or a first_name and last_name pair.Endpoint
POST
https://api.provero.io/api/fraud-check/nameHeaders
Authorization:
Content-Type: application/json
Accept: application/json
Request Body
Request Payload Example (JSON)
{
"full_name": "John Doe",
"first_name": "string",
"last_name": "string"
}Request Examples
Choose language Bash (cURL) 5 examples
full_name="John Doe"
curl -X POST https://api.provero.io/api/fraud-check/name \
-H "Authorization: Bearer REPLACE_WITH_API_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d "{\"full_name\": \"$full_name\"}"import requests
full_name = "John Doe"
url = "https://api.provero.io/api/fraud-check/name"
payload = {"full_name": full_name}
headers = {
"Authorization": "Bearer REPLACE_WITH_API_TOKEN",
"Content-Type": "application/json",
"Accept": "application/json"
}
response = requests.post(url, headers=headers, json=payload)
print(response.status_code)
print(response.text)<?php
$fullName = "John Doe";
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.provero.io/api/fraud-check/name",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POSTFIELDS => json_encode([
"full_name" => $fullName
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer REPLACE_WITH_API_TOKEN",
"Content-Type: application/json",
"Accept: application/json"
],
]);
$response = curl_exec($curl);
if (curl_errno($curl)) {
echo 'Error:' . curl_error($curl);
}
curl_close($curl);
echo $response;$fullName = "John Doe";
$response = Http::withToken('REPLACE_WITH_API_TOKEN')
->acceptJson()
->post('https://api.provero.io/api/fraud-check/name', [
'full_name' => $fullName,
]);
return $response->json();const fullName = "John Doe";
fetch("https://api.provero.io/api/fraud-check/name", {
method: "POST",
headers: {
"Authorization": "Bearer REPLACE_WITH_API_TOKEN",
"Content-Type": "application/json",
"Accept": "application/json"
},
body: JSON.stringify({ full_name: fullName })
})
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.error("Error:", error));Response Examples
Choose response example Success 3 examples
{
"fullName": "John Doe",
"type": "full_name",
"isValid": true,
"isProfane": false,
"riskLevel": "LOW",
"notes": "Name passed heuristic screening."
}{
"message": "The full_name field is required when first_name and last_name are not provided.",
"errors": {
"full_name": [
"The full_name field is required when first_name and last_name are not provided."
]
}
}{
"message": "Insufficient balance for validation request.",
"service": "name",
"required_amount": "0.0060000000",
"current_balance": "0.0000000000"
}