const response = await fetch('https://service.pcibooking.net/api/verify', {
method: 'POST',
headers: {
'Authorization': 'APIKEY your-api-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
email: 'john.doe@example.com',
phone: '972544735557',
personName: 'John Doe',
language: 'en',
ttlMinutes: 15,
callbackUrl: 'https://yourplatform.com/verify-callback',
metadata: 'MY-REFERENCE_098'
})
});
const data = await response.json();
console.log(data);
import requests
response = requests.post(
'https://service.pcibooking.net/api/verify',
headers={
'Authorization': 'APIKEY your-api-key',
'Content-Type': 'application/json'
},
json={
'email': 'john.doe@example.com',
'phone': '972544735557',
'personName': 'John Doe',
'language': 'en',
'ttlMinutes': 15,
'callbackUrl': 'https://yourplatform.com/verify-callback',
'metadata': 'MY-REFERENCE_098'
}
)
print(response.json())
{
"verifyId": "xLoat3F385vvFRbgI2usOeuXKXQoB8kv",
"status": "Pending",
"expiresAt": "2026-03-15T18:44:21Z"
}
{
"code": -125,
"message": "Bad input data",
"moreInfo": "...",
"errorList": null
}
Contact Verification
Create a Verification
Initiate a new contact details verification via email and OTP.
POST
/
api
/
verify
const response = await fetch('https://service.pcibooking.net/api/verify', {
method: 'POST',
headers: {
'Authorization': 'APIKEY your-api-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
email: 'john.doe@example.com',
phone: '972544735557',
personName: 'John Doe',
language: 'en',
ttlMinutes: 15,
callbackUrl: 'https://yourplatform.com/verify-callback',
metadata: 'MY-REFERENCE_098'
})
});
const data = await response.json();
console.log(data);
import requests
response = requests.post(
'https://service.pcibooking.net/api/verify',
headers={
'Authorization': 'APIKEY your-api-key',
'Content-Type': 'application/json'
},
json={
'email': 'john.doe@example.com',
'phone': '972544735557',
'personName': 'John Doe',
'language': 'en',
'ttlMinutes': 15,
'callbackUrl': 'https://yourplatform.com/verify-callback',
'metadata': 'MY-REFERENCE_098'
}
)
print(response.json())
{
"verifyId": "xLoat3F385vvFRbgI2usOeuXKXQoB8kv",
"status": "Pending",
"expiresAt": "2026-03-15T18:44:21Z"
}
{
"code": -125,
"message": "Bad input data",
"moreInfo": "...",
"errorList": null
}
Contact Verification Guide
How the email + OTP verification flow works end-to-end
Error Responses
| HTTP Status | Error Code | Description |
|---|---|---|
| 400 | -125 | Validation error. Required fields are missing or have invalid format (e.g. invalid email, phone number, or ttlMinutes out of range). |
| 401 | none | Not authenticated. The API key is missing or invalid. The response body is empty. |
| 500 | -150 | Internal system error. Identity could not be resolved after authentication. |
Parameter Constraints
| Parameter | Constraint |
|---|---|
email | Required. Must be a valid email address. |
phone | Required. International format with country code, no leading + sign. Must contain 8 to 20 digits. |
personName | Optional. Max 100 characters. |
language | Optional. Defaults to en. Supported: en, es, fr, de, it, pt, nl, pl, ru, ja, ko, zh, ar, hi, tr, sv, da, nb, no, ro, is, plus regional variants. |
ttlMinutes | Optional. Integer from 1 to 30. Defaults to 10. |
callbackUrl | Optional. Must be a valid URL. |
Phone numbers must be in international format, including the country code, without a leading
+ sign (e.g. 972544735557).Parameters
Authentication
API key only. This endpoint does not accept access tokens or session tokens.Your API key prefixed with
APIKEY. Example: APIKEY your-api-key. The x-pcibooking-api-key header is also accepted. See the Authentication guide.Contact Details
The phone number to verify via OTP, in international format without a leading
+ sign (e.g. 972544735557).Message Options
SMS sender name, up to 11 characters. Defaults to your PCI Booking user ID. Some countries do not allow a name as the sender; there the SMS comes from a number.
The language for the email and verification page, as a two-letter ISO 639-1 code (e.g.
en).How long the verification link stays valid, in minutes. Allowed range: 1 to 30. If the recipient opens the link after this time, or the link is not valid, the verification page shows the error “Session expired or invalid”. Create a new verification to send a fresh link.
Callback & Tracking
A URL to which PCI Booking will POST the result when the session reaches a terminal state. See Receive Result Notification.
A free-form reference string stored with the session and echoed back in all responses and callbacks.
const response = await fetch('https://service.pcibooking.net/api/verify', {
method: 'POST',
headers: {
'Authorization': 'APIKEY your-api-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
email: 'john.doe@example.com',
phone: '972544735557',
personName: 'John Doe',
language: 'en',
ttlMinutes: 15,
callbackUrl: 'https://yourplatform.com/verify-callback',
metadata: 'MY-REFERENCE_098'
})
});
const data = await response.json();
console.log(data);
import requests
response = requests.post(
'https://service.pcibooking.net/api/verify',
headers={
'Authorization': 'APIKEY your-api-key',
'Content-Type': 'application/json'
},
json={
'email': 'john.doe@example.com',
'phone': '972544735557',
'personName': 'John Doe',
'language': 'en',
'ttlMinutes': 15,
'callbackUrl': 'https://yourplatform.com/verify-callback',
'metadata': 'MY-REFERENCE_098'
}
)
print(response.json())
Response
| Field | Type | Description |
|---|---|---|
verifyId | string | The unique ID of the verification session. Use this in all subsequent status and results calls. |
status | string | The initial status. Always Pending on creation. |
expiresAt | datetime | The UTC datetime at which the verification link expires, based on ttlMinutes. ISO 8601 format. |
{
"verifyId": "xLoat3F385vvFRbgI2usOeuXKXQoB8kv",
"status": "Pending",
"expiresAt": "2026-03-15T18:44:21Z"
}
{
"code": -125,
"message": "Bad input data",
"moreInfo": "...",
"errorList": null
}

