API
Authentication
Usage of Pepchecker is not tied to your login credentials or the active session on pepchecker.com. To authenticate check requests, use the API keys available under the "Developer" tab in your Pepchecker dashboard. The API key is used as a request header.
Check request endpoint
GET https://pepchecker.com/api/v1/check
Query parameters
Headers
Response body
{
"pepList" : [ {
"title" : "Mr.",
"firstName" : "Donald John",
"lastName" : "Trump",
"gender" : "MALE",
"aliases" : "Trump, Donald J.",
"original" : null,
"function" : "Executive Office of the President, White House Office",
"specific" : "Ex President of the United States of America",
"country" : "United States of America",
"possibleBirthDates" : [ "1946-06-14" ],
"active" : false
}, {
"title" : "Mr.",
"firstName" : "Donald John III",
"lastName" : "Trump",
"gender" : "MALE",
"aliases" : "Trump, Donnie John III; Trump, Don; Trump, Donald III",
"original" : null,
"function" : "Relatives of High Officials",
"specific" : "Son of Donald John Jr. Trump",
"country" : "United States of America",
"possibleBirthDates" : [ "2009-02-18" ],
"active" : true
} ],
"sanctionList" : [ ]
}
Environment keys
Every account has two API keys associated with it - the Test key and the Production key. The Production key can be used to search any requested names, and requests using the Production key will be tracked according to your account's subscription plan - the key can be used freely within your account's Monthly free requests limit, visible on the Dashboard. After this limit is reached, a fixed metered price will be applied to each subsequent request. The Test key can be used without incurring costs and does not count towards your account's Monthly free requests limit. However, the Test key can only be used to search for information about specific names.
Valid Test key names
The following names can be used to do free requests using the Test API key.
Gil Shaki
Paul Lanser
Ahmed Al Khalid
Sultan Abdallah
Makmum Rasjid
Trong Kien
Maman Rudyana
Ana Cristina
Mary Barret
Zúñiga Chaves
Vladimir Putin
Giovanni Battista
Anatoly Afanasevich
Ahmet Hamdi
Ben Mustapha
Lik Ma
Sum Yeung
Wescott-Williams Sarah
Bausch Francois
Sali Ram
David Lindon
Code examples
The following page contains code examples of common languages for convenient integration with the Pepchecker check request endpoint.
Java example
String apiKey = "test-d8269f8b-721a-42bf-8dba-6d2a30dcff68";
String firstName = "Donald";
String lastName = "Trump";
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://pepchecker.com/api/v1/check?firstName=" + firstName + "&lastName=" + lastName))
.header("api-key", apiKey)
.build();
HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
Curl example
curl "https://pepchecker.com/api/v1/check?firstName=Donald&lastName=Trump&apiKey=test-d8269f8b-721a-42bf-8dba-6d2a30dcff68"
PHP example
$apiKey = 'test-d8269f8b-721a-42bf-8dba-6d2a30dcff68';
$firstName = 'Donald';
$lastName = 'Trump';
$opts = array(
'http' => array(
'method' => "GET",
'header' => "api-key: " . $apiKey . "\r\n"
)
);
$context = stream_context_create($opts);
$response = file_get_contents('https://pepchecker.com/api/v1/check?firstName=' . $firstName . '&lastName=' . $lastName, false, $context);
var_dump($response);
JS example
const http = new XMLHttpRequest();
const apiKey = 'test-d8269f8b-721a-42bf-8dba-6d2a30dcff68';
const firstName = 'Donald';
const lastName = 'Trump';
http.setRequestHeader('api-key', apiKey);
http.open('GET', 'https://pepchecker.com/api/v1/check?firstName=' + firstName + '&lastName=' + lastName);
http.send();
http.onreadystatechange = (e) => {
console.log(http.responseText)
};
Python example
import urllib3
http = urllib3.PoolManager()
apiKey = 'test-d8269f8b-721a-42bf-8dba-6d2a30dcff68'
firstName = 'Donald'
lastName = 'Trump'
uri = 'https://pepchecker.com/api/v1/check?firstName=' + firstName + '&lastName=' + lastName
response = http.request('GET', uri, headers={
'api-key': apiKey
})
print(response.data)