Vehicle Plate Number Verification

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 -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)"
  }
}