# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/biluppgifter/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/biluppgifter/get-make-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/biluppgifter/get-vehicle-by-registration \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/biluppgifter/get-vehicle-history \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/biluppgifter/get-vehicle-owner-info \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/biluppgifter/get-vehicle-valuation \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/biluppgifter/list-makes \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/biluppgifter/search-vehicles-by-partial-plate \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.