# Biluppgifter — 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.

> Look up Swedish vehicle details, valuations, ownership information, and complete history using registration plates or partial matches. Search by vehicle make, access fleet statistics, and get current market valuations all from the official Swedish vehicle registry.

**Category:** Automotive | **Website:** [biluppgifter.se/](https://biluppgifter.se/) | **Docs:** [parse.bot/marketplace/d4fd3f00-d092-4663-9b38-04eff3bdda6d/biluppgifter-se-api](https://parse.bot/marketplace/d4fd3f00-d092-4663-9b38-04eff3bdda6d/biluppgifter-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-biluppgifter-se-api-d4fd3f00/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_make_details

Get all models for a specific vehicle make. Returns the make slug and an array of model objects with name and slug. The make_slug must match a slug from list_makes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `make_slug` | string | Yes | Make slug as returned by list_makes (e.g. volvo, bmw, toyota). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-biluppgifter-se-api-d4fd3f00/get_make_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"make_slug":"<string>"}'
```

### get_vehicle_by_registration

Fetch detailed vehicle information by Swedish registration number. Returns make, model, technical specs, inspection history, owner history, and extensive technical data. The response includes dozens of fields from the registry (Swedish-language keys). Some fields (exterior, interior, motorkod, tecdoc_id) require site login and show 'Logga in' as placeholder.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `regnr` | string | Yes | Swedish vehicle registration number (e.g. ABC001, GHF663). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-biluppgifter-se-api-d4fd3f00/get_vehicle_by_registration \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"regnr":"<string>"}'
```

### get_vehicle_history

Get vehicle event history including inspections, owner changes, traffic status changes, and advertisements. Returns chronologically ordered events with date, title, and description.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `regnr` | string | Yes | Swedish vehicle registration number (e.g. ABC001, GHF663). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-biluppgifter-se-api-d4fd3f00/get_vehicle_history \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"regnr":"<string>"}'
```

### get_vehicle_owner_info

Get owner history for a vehicle. Returns owner type and date of each ownership change. Detailed owner names require BankID authentication and are not available through this endpoint.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `regnr` | string | Yes | Swedish vehicle registration number (e.g. ABC001, GHF663). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-biluppgifter-se-api-d4fd3f00/get_vehicle_owner_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"regnr":"<string>"}'
```

### get_vehicle_valuation

Get market valuation history and forecast for a vehicle by registration number. Returns valuation time series with historic, current, and forecast values in SEK. If mileage is not provided, it is auto-fetched from the vehicle page. Price range and loan cost fields may be empty as they require site authentication.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `mileage` | integer | No | Odometer reading in Swedish 'mil' (1 mil = 10 km). If omitted, the value is auto-fetched from the vehicle page. |
| `regnr` | string | Yes | Swedish vehicle registration number (e.g. ABC001, GHF663). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-biluppgifter-se-api-d4fd3f00/get_vehicle_valuation \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mileage":"<integer>","regnr":"<string>"}'
```

### list_makes

List all vehicle makes available in the Swedish vehicle registry. Returns name, slug, country of origin, and registered vehicle count for each make. No parameters required.

**Estimated cost:** Metered

_No parameters required._

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

### search_vehicles_by_partial_plate

Search for vehicles by registration plate prefix. The query must be a valid Swedish plate prefix (letters and/or digits from the start of a plate). Returns a list of matching vehicles with basic info. Non-plate text queries (e.g. make names) return an empty list.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Registration plate prefix to search (e.g. ABC, GHF). Must be the beginning of a valid Swedish plate number. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-biluppgifter-se-api-d4fd3f00/search_vehicles_by_partial_plate \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```