API Reference

The Fixaroo Parts API is a REST API that gives you programmatic access to UK vehicle parts data, VRM lookup, fitment information, and multi-supplier pricing.

Authentication #

All API requests must include your API key in the X-API-Key header.

bash

curl https://api.fixaroo.co/v1/parts/search \
  -H "X-API-Key: fxr_your_api_key..." \
  -G --data-urlencode "q=brake pads"

Keep your key secret. Never expose it in frontend JavaScript or public repositories. Rotate it from your dashboard if it's ever compromised.

Base URL #

text

https://api.fixaroo.co

All endpoints are versioned under /v1. We maintain backwards compatibility within a major version.

Errors #

The API uses standard HTTP status codes. Error responses include a JSON body with a machine-readable code and human-readable message.

Status	Meaning
`200`	Success
`400`	Bad request — missing or invalid parameters
`401`	Unauthorized — invalid or missing API key
`403`	Forbidden — endpoint not available on your plan
`404`	Not found
`429`	Rate limit exceeded
`500`	Server error

json

{
  "error": {
    "code": "INVALID_API_KEY",
    "message": "The API key provided is invalid or has been revoked."
  }
}

Rate limits #

Rate limits are enforced per API key. Headers on every response tell you your current state:

Plan	Requests/day
Free	100
Pro	10,000
Enterprise	100,000

text

X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 9847
X-RateLimit-Reset: 1711584000

Parts

GET

/v1/parts/search

Search the parts catalogue by keyword, part number, or OEM reference.

Query parameters

Param	Type	Required	Description
`q`	string	Yes	Search query — keyword, part number, or OEM ref
`category`	string	No	Filter by category slug (e.g. `brakes`, `suspension`)
`brand`	string	No	Filter by brand name
`page`	integer	No	Page number (default: 1)
`per_page`	integer	No	Results per page, max 100 (default: 20)

Example request

bash

curl "https://api.fixaroo.co/v1/parts/search?q=brake+pads&category=brakes" \
  -H "X-API-Key: fxr_your_key..."

Response

json

{
  "data": [
    {
      "id": "part_2xKj91aB3mNq",
      "name": "Brembo Front Brake Pads",
      "part_number": "P06020",
      "oem_numbers": ["1J0698151B", "1J0698151"],
      "brand": "Brembo",
      "category": "brakes",
      "description": "High-performance front brake pads for everyday driving.",
      "price_from": 2499,
      "currency": "GBP",
      "in_stock": true,
      "suppliers": 6
    }
  ],
  "meta": {
    "total": 142,
    "page": 1,
    "per_page": 20,
    "last_page": 8
  }
}

GET

/v1/parts/{id}

Retrieve full details for a single part, including all supplier pricing and stock.

Path parameters

id string Yes Part ID from the search response

Example request

bash

curl "https://api.fixaroo.co/v1/parts/part_2xKj91aB3mNq" \
  -H "X-API-Key: fxr_your_key..."

Response

json

{
  "id": "part_2xKj91aB3mNq",
  "name": "Brembo Front Brake Pads",
  "part_number": "P06020",
  "oem_numbers": ["1J0698151B", "1J0698151"],
  "brand": "Brembo",
  "category": "brakes",
  "description": "High-performance front brake pads for everyday driving.",
  "specifications": {
    "width_mm": 155,
    "height_mm": 65,
    "thickness_mm": 20
  },
  "suppliers": [
    {
      "name": "GSF Car Parts",
      "sku": "GSF-B01234",
      "price": 2499,
      "currency": "GBP",
      "in_stock": true,
      "stock_qty": 48,
      "delivery_days": 1
    },
    {
      "name": "Euro Car Parts",
      "sku": "ECP-4567890",
      "price": 2699,
      "currency": "GBP",
      "in_stock": true,
      "stock_qty": 12,
      "delivery_days": 2
    }
  ]
}

GET

/v1/parts/{id}/fitment

List all vehicles that a part is compatible with.

Example request

bash

curl "https://api.fixaroo.co/v1/parts/part_2xKj91aB3mNq/fitment" \
  -H "X-API-Key: fxr_your_key..."

Response

json

{
  "part_id": "part_2xKj91aB3mNq",
  "fitment": [
    {
      "make": "Volkswagen",
      "model": "Golf",
      "year_from": 2013,
      "year_to": 2020,
      "engine": "1.4 TSI",
      "axle": "front"
    },
    {
      "make": "Audi",
      "model": "A3",
      "year_from": 2012,
      "year_to": 2019,
      "engine": "All",
      "axle": "front"
    }
  ]
}

Vehicles

GET

/v1/vehicles/lookup

Resolve a UK Vehicle Registration Mark (number plate) to full vehicle details.

Pro & Enterprise only

Query parameters

vrn string Yes UK registration number (spaces optional)

Example request

bash

curl "https://api.fixaroo.co/v1/vehicles/lookup?vrn=AB12CDE" \
  -H "X-API-Key: fxr_your_key..."

Response

json

{
  "vrn": "AB12CDE",
  "make": "Ford",
  "model": "Focus",
  "variant": "Titanium",
  "year": 2012,
  "engine": "1.6L TDCi 115ps",
  "fuel": "diesel",
  "transmission": "manual",
  "body": "hatchback",
  "doors": 5,
  "colour": "Blue"
}

GET

/v1/vehicles/{make}/{model}/{year}/parts

List compatible parts for a specific vehicle, optionally filtered by category.

Path parameters

`make`	string	Yes	Make slug (e.g. `ford`, `volkswagen`)
`model`	string	Yes	Model slug (e.g. `focus`, `golf`)
`year`	integer	Yes	Model year (e.g. `2019`)

Query parameters

`category`	string	No	Filter by category (e.g. `brakes`, `filters`)
`page`	integer	No	Page number (default: 1)

Example request

bash

curl "https://api.fixaroo.co/v1/vehicles/ford/focus/2019/parts?category=brakes" \
  -H "X-API-Key: fxr_your_key..."

Response

json

{
  "vehicle": {
    "make": "Ford",
    "model": "Focus",
    "year": 2019
  },
  "data": [
    {
      "id": "part_2xKj91aB3mNq",
      "name": "Brembo Front Brake Pads",
      "part_number": "P06020",
      "brand": "Brembo",
      "category": "brakes",
      "price_from": 2499,
      "currency": "GBP",
      "in_stock": true
    }
  ],
  "meta": {
    "total": 34,
    "page": 1,
    "per_page": 20
  }
}

Need help?

The API uses standard REST conventions. If you have questions or hit an issue, reach out at [email protected]. Enterprise customers get a dedicated Slack channel.

Create a free account to get your API key →