Developer Portal
Access tools, documentation, and resources to integrate with the AskMid Motor Insurance Database API.
// Quick example: Check vehicle insurance
const response = await fetch(
'https://api.askmid.net/v1/vehicles/check',
{
method: 'POST',
headers: {
'Authorization': `Bearer $${YOUR_API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
registration: 'AB12CDE'
})
}
);
API Documentation
The AskMid API provides programmatic access to the Motor Insurance Database, allowing you to verify vehicle insurance status, retrieve policy details, and more.
All API requests require authentication using your API key. Make sure to include your API key in the Authorization header of each request.
Base URL
https://api.askmid.net/v1Authentication
All API requests must include your API key in the Authorization header:
Authorization: Bearer YOUR_API_KEYEndpoints
POST/vehicles/check
Check if a vehicle is insured based on its registration number.
Request Body
{
"registration": "AB12CDE"
}Response
{
"status": "success",
"data": {
"registration": "AB12CDE",
"insured": true,
"policyStatus": "active",
"lastChecked": "2025-05-07T14:12:33Z"
}
}Example Request
curl -X POST https://api.askmid.net/v1/vehicles/check -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{
"registration": "AB12CDE"
}'GET/vehicles/{registration}/policy
POST/vehicles/batch-check
Error Codes
| Status Code | Error Code | Description |
|---|---|---|
| 400 | invalid_request | The request was malformed or missing required parameters |
| 401 | unauthorized | Invalid or missing API key |
| 403 | forbidden | Your API key doesn't have permission to access this resource |
| 404 | not_found | The requested resource was not found |
| 429 | rate_limit_exceeded | You've exceeded your rate limit |
| 500 | server_error | An error occurred on our servers |
Need Help?
If you have any questions or need assistance with the API, please don't hesitate to contact our developer support team.