Paintbase API

https://api.paintbase.app

Authentication

Authorization: Bearer <api_key>

Endpoints

GET /v1/test

Used to test your api key.

GET /v1/vehicle/:vin

Lookup vehicle data by VIN.

• Requires Authorization: Bearer <api_key>
• VIN must be 11-17 characters

GET /v1/vehicle/:regno/:country

Lookup vehicle data by registration number and country.

• country must be one of: SE, NO, DK, FI, NL, GB, UK

Response 200 OK

{
  "displayName": "string",
  "vin": "string",
  "make": "string",
  "model": "string",
  "color_code": "string",
  "vehicleYear": "string"
}

Rate limit response headers

• X-RateLimit-Limit
• X-RateLimit-Remaining
• X-RateLimit-Reset

Errors

Common response codes:

• 400 Invalid input (for example VIN length or country code)
• 401 Missing or invalid API key
• 403 Out of credits
• 404 Vehicle or route not found
• 502 Upstream provider unavailable

Example error response

{
  "error": "Bad Gateway",
  "message": "Failed to reach the upstream data provider. Please try again later."
}