Developers

Test it before you sign anything.

Two APIs, one portal. The free key covers the catalogue; lookups start with a pack or plan. Both are REST with JSON answers and your key in the Authorization header. The examples below run against production, capped for the public page.

Free test key

Get a free test key

Try the Catalogue API free for 14 days: up to 1,000 calls a day, every make, model and year. No card. Plate and VIN demos use the sample cars; your own cars need a lookup pack or plan. The portal invite arrives by email straight away.
Client portal
No card. We email you a link to the portal.
Plate & VIN Lookup

Plate or VIN to the factory paint

The public page reads seven sample cars. With a key, any UK plate or VIN for the 26 makes we cover.

Pick a sample car. With a key, any UK plate or VIN.
Or try a sample:
# Plate & VIN Lookup · mycarcolor.com
Authorization: Bearer mcc_sk_…

GET /api/v1/vehicle/paint-code
    ?plate=CJ71DSY
GET /api/v1/vehicle/paint-code
    ?vin=WBA52BX0X07T62567
GET /api/v1/vehicle/build-spec
    ?vin=…          trim, engine, options
GET /api/v1/vehicle/brands
    what each make returns (free)
Catalogue API

Every colour by car, name or code

The picker your store would show, and search across 113,000 colours, on examples we chose. Every feature, for one fixed monthly price.

live · GET /search/v3/?brand_id&model_id&year
Reading the catalogue…
# Catalogue API · api.mycarcolor.com
Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET

GET /search/v3/?brand_id=…&model_id=…&year=2019
GET /search/v3/?q=nardo+grey

The picker endpoints (makes, models, years), every parameter and the response fields are in the Catalogue API reference.

The client portal

Keys, usage and the full reference.

Every client gets a portal with test keys, daily usage, the reference in curl, JavaScript and Python, and a playground on their own key. Here it is searching for Nardo grey.

API

The contract

Authentication

A key per environment, sent in the Authorization header. Keys are created and rotated in the client portal, each with its own rate limit and daily cap.

Billing

A paint lookup is billed only when it returns a code. Not-found vehicles and unsupported makes are free, and so is the coverage list.

Errors and retries

401 bad key · 400 bad identifier · 404 no vehicle · 429 rate limited, with retry-after · 502 upstream, retry. A first-time VIN can take up to 25 seconds; a car read before, well under one.

What you may do with it

Show it in your product and keep it for your own customers. No redistribution and no bulk export.