Vehicle Plate Number

This endpoint allows you to verify the validity of a vehicle plate number.

Endpoint: POST {baseurl}/v1/api/verification/plate-number

Request Body

Parameter	Type	Required	Description
vehicleNumber	string	Yes	The vehicle plate number to verify.
country	string	Yes	The country code (e.g., "NGA" for Nigeria).
reference	string	Yes	A unique reference for the verification request.
verificationLevel	string	No	The level of verification to perform (e.g., "basic").
customer	string	No	ID of the customer (optional).
verificationGroup	string	No	ID of the verification group (optional).

Sample Request

curl

curl -X 'POST' \
  'http://localhost:4000/v1/api/verification/plate-number' \
  -H 'accept: application/json' \
  -H 'x-api-key: {API-KEY}' \
  -H 'Content-Type: application/json' \
  -d '{
  "vehicleNumber": "4444444444",
  "country": "NGA",
  "reference": "09876543567890000002020008006",
  "verificationLevel": "basic",
  "customer": "68922a8c839016cfca2ff038",
  "verificationGroup": "68ada27c2e94452b66f779b0"
}'

Sample Response

{
  "status": true,
  "responseCode": "00",
  "statusCode": "200",
  "message": "Vehicle plate number verification successful",
  "data": {
    "vehicleNumber": "4444444444",
    "vehicleMake": "Toyota",
    "vehicleModel": "Camry",
    "vehicleColor": "White",
    "registrationYear": "2020",
    "ownerName": "John Doe"
  },
  "meta": {
    "statusCode": "200",
    "isValid": true,
    "timeStamp": "Wed Apr 23 2025 07:17:01 GMT+0000 (Coordinated Universal Time)"
  }
}