Documentation
Welcome to Vehicle Databases API's Documentation
License Plate OCR
POSTRate LimitedJSON Response
Overview
This API endpoint returns the license plate number and state from the license plate image.
For USA
This API endpoint returns the license plate number and state from the license plate image.
For UK
This API endpoint returns the license plate number from the license plate image.
Supported Formats
PNG, JPG, and JPEG image formats are supported.
HTTP Request
Endpoint
POST https://api.vehicledatabases.com/licenseplate-ocrExample — Python / Requests
Target:
Client:
import requests
response = requests.post(
"https://api.vehicledatabases.com/licenseplate-ocr",
headers={"x-authkey":"YOUR_API_KEY"}
files=[
('file',('test.jpg',open('test.jpg','rb'),'image/jpeg'))
]
)
print(response.json())GET Parameters
| Parameter | Required | Description |
|---|---|---|
| file | ✓ | Image having a licence plate |
JSON Response
This API returns lincese plate number and state.
| Parameter | Description |
|---|---|
| status | success or error |
| data | Provides license plate and state |
Example Response US
{
"status": "success",
"data": {
"plate": "CN31613",
"state": "IL"
}
}Example Response UK
{
"status": "success",
"data": {
"plate": "WJ59FHA",
"state": "UK"
}
}Error Responses
error
statusWhen an error occurs, the API returns an error status with a code and message.
| Code | Description | Resolution |
|---|---|---|
| 400 | No Record(s) were found. | Check the uploaded image that license plate is clearly visible. |
| 401 | Invalid API key. | Provide a valid API key. |
| 404 | API endpoint not found | Check the API endpoint URL. |
| 429 | Rate limit exceeded | Reduce request frequency to comply with rate limits. |