> ## Documentation Index
> Fetch the complete documentation index at: https://docs.remapdb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Use the Remapdb Vehicle Tuning Database API to browse the vehicle hierarchy, retrieve detailed engine and generation metadata, validate API access, and build vehicle search and quoting workflows.

## Remapdb Vehicle Tuning Database API

The Remapdb REST API lets you programmatically access comprehensive vehicle details, including types, manufacturers, models, engines, ECU and TCU info, tuning tools, dyno charts, and available tuning or remap stages with their performance gains.

<Info>
  Need AI tools to search this data for you? API access also supports MCP-based setup through [AI Integrations](/api/ai-integrations).
</Info>

## Endpoints

* [`GET /subscription`](/api-reference/subscription/active-subscription): Check whether the authenticated API key has active API access.
* [`GET /types`](/api-reference/types/vehicle-types): List available vehicle types.
* [`GET /manufacturers/type/{type_id}`](/api-reference/manufacturers/manufacturers-by-type): List manufacturers for a vehicle type.
* [`GET /manufacturers/{manufacturer_id}`](/api-reference/manufacturers/manufacturer-details): Get manufacturer details.
* [`GET /models/manufacturer/{manufacturer_id}`](/api-reference/models/models-by-manufacturer): List models for a manufacturer.
* [`GET /models/{model_id}`](/api-reference/models/model-details): Get model details.
* [`GET /generations/model/{model_id}`](/api-reference/generations/generations-by-model): List generations for a model.
* [`GET /generations/{generation_id}`](/api-reference/generations/generation-details): Get generation details.
* [`GET /engines/generation/{generation_id}`](/api-reference/engines/engines-by-generation): List engines for a generation.
* [`GET /engines/{engine_id}`](/api-reference/engines/engine-details): Get engine details, including performance and tuning information.
* [`GET /search`](/api-reference/search/vehicle-search): Search across manufacturers, models, generations, and engines.

## Common Use Cases

* Build a vehicle selector flow: Start from `GET /types`, then drill down through manufacturers, models, generations, and engines.
* Validate API access before data calls: Use `GET /subscription` during app startup or before running batch jobs.
* Power quoting and lead forms: Use `/search` to quickly resolve vehicle entities and then fetch full metadata by ID.
* Render detailed vehicle pages: Fetch model, generation, and engine detail endpoints to display structured specs and tuning context.
* Support multilingual customer experiences: Send `Accept-Language` per request to localize returned data.

## Authentication

All endpoints require Bearer authentication.

Generate and manage your API key from your Remapdb account, then send:

```bash theme={null}
Authorization: Bearer <API_KEY>
```

Example:

```bash theme={null}
curl -X GET "https://api.remapdb.com/v1/types" \
  -H "Authorization: Bearer <API_KEY>"
```

## Base URL

`https://api.remapdb.com/v1`

## Language

All methods support language selection via the `Accept-Language` header.
If omitted, English (`en`) is used.

Example:

```bash theme={null}
curl "https://api.remapdb.com/v1/search?query=audi" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Accept-Language: nl"
```

## Rate Limits

Rate limits apply to all API methods and are tied to your API key and subscription plan.
Limits reset every hour.

## Response and Errors

The API returns `application/json` responses.

* Success responses return `2XX` codes.
* Error responses return `4XX` or `5XX` codes with an error object containing:
  * `code` (integer)
  * `message` (string)