# Bildelsbasen — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Find and browse used car parts from Bildelsbasen's inventory by vehicle make, model, registration number, or OEM part number. Get detailed information about available dismantled parts, including pricing and specifications from listed companies.

**Category:** Automotive | **Website:** [bildelsbasen.se/](https://bildelsbasen.se/) | **Docs:** [parse.bot/marketplace/12517df9-25d7-4da9-9861-f85d928294c5/bildelsbasen-se-api](https://parse.bot/marketplace/12517df9-25d7-4da9-9861-f85d928294c5/bildelsbasen-se-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-bildelsbasen-se-api-12517df9/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_parts_from_vehicle

Lists all available dismantled parts from a specific vehicle (vpost_id).

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bildelsbasen-se-api-12517df9/get_all_parts_from_vehicle \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_companies

Retrieves a paginated list of affiliated dismantler companies, sorted by rating. Each company includes contact information, business hours, review statistics (recommendation percentage, median handle time), and address details. Use offset and limit for pagination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of companies to return per page. |
| `offset` | integer | No | Pagination offset (number of results to skip). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bildelsbasen-se-api-12517df9/get_companies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>"}'
```

### get_makes

Returns all car makes/brands available on the site. Each make includes a numeric identifier (vc1), display name (vt1), popularity flag, and whether parts currently exist in inventory. Results are sorted alphabetically by default. Use the vt1 value as the make parameter in subsequent calls.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bildelsbasen-se-api-12517df9/get_makes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_models

Returns all models available for a specific car make. Each model includes numeric identifiers (vc1, vc2), display name (vt2), popularity score, existence flag, and code variants with model year ranges. Use the vt2 value as the model parameter in subsequent calls.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `make` | string | Yes | Car make/brand name exactly as returned by get_makes in the vt1 field (e.g. 'Audi', 'Volvo', 'BMW'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bildelsbasen-se-api-12517df9/get_models \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"make":"<string>"}'
```

### get_part_categories

Returns all top-level part categories for a specific make and model. Each category includes a numeric ID (pc1), display name (pt1), image path, and existence flag indicating whether parts are currently in stock. Use the vt2 value from get_models as the model parameter and the pt1 value in subsequent get_part_subcategories calls.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `make` | string | Yes | Car make/brand name (e.g. 'Audi'). |
| `model` | string | Yes | Car model identifier, the vt2 value from get_models (e.g. 'Q7', 'A3, S3'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bildelsbasen-se-api-12517df9/get_part_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"make":"<string>","model":"<string>"}'
```

### get_part_detail

Retrieves full details for a single dismantled car part by its internal ID.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bildelsbasen-se-api-12517df9/get_part_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_part_subcategories

Returns subcategories and individual part types within a major category for a specific make and model. The response includes a hierarchy of subcategories (pc2/pt2) each containing article arrays with specific part types (pc/pt3) and their position variants. Use the pt1 value from get_part_categories as the category parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category name, the pt1 value from get_part_categories (e.g. 'Airbag', 'Motor'). |
| `make` | string | Yes | Car make/brand name (e.g. 'Audi'). |
| `model` | string | Yes | Car model identifier, the vt2 value from get_models (e.g. 'Q7'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bildelsbasen-se-api-12517df9/get_part_subcategories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","make":"<string>","model":"<string>"}'
```

### search_by_registration

Looks up a vehicle by its registration plate number to identify make, model, engine details, and other vehicle specifications. Returns populated fields when the plate is found in the database (found=true), or null fields when not found (found=false). Supports Nordic country plates.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Country code for the plate lookup. Accepted values: 'SE' (Sweden), 'NO' (Norway), 'DK' (Denmark), 'IS' (Iceland). |
| `plate_number` | string | Yes | Vehicle registration plate number (e.g. 'ABC123' for Swedish plates). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bildelsbasen-se-api-12517df9/search_by_registration \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","plate_number":"<string>"}'
```

### search_parts

Searches for dismantled car parts using various filters. Use oem for specific part number search.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bildelsbasen-se-api-12517df9/search_parts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```