# Avis — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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.

> Search and explore Avis Germany rental locations with autocomplete functionality, view detailed location information and available vehicles, and discover current special offers. Find rental options by country or city to compare fleet availability and pricing.

**Category:** Travel | **Website:** [avis.de/](https://avis.de/) | **Docs:** [parse.bot/marketplace/5ffb71b4-15c2-482a-a8bd-2fb763ece6e8/avis-de-api](https://parse.bot/marketplace/5ffb71b4-15c2-482a-a8bd-2fb763ece6e8/avis-de-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/avis/`
**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 current offers

Get current special offers and promotions from the Avis Germany offers page. Returns all active promotions with title and URL. Results may change over time as promotions are updated.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/avis/get-current-offers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get location details

Get detailed information for a specific Avis rental location by its station code, including address, phone, coordinates, and opening hours. The code is obtained from search_locations_autocomplete results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `code` | string | Yes | Avis station code (e.g. 'FRA', 'F9T', 'MUC', 'BER'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/avis/get-location-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"code":"<string>"}'
```

### Get locations by city

Get all rental branches in a specific city. Requires the full city page URL as returned by get_locations_by_country. Each branch has a name and URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city_url` | string | Yes | Full URL of the city page (e.g. 'https://www.avis.de/rund-um-avis/mietwagen-stationen/europa/deutschland/frankfurt'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/avis/get-locations-by-city \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"city_url":"<string>"}'
```

### Get locations by country

Get a list of cities in Germany that have Avis rental locations. Returns city names and their page URLs for use with get_locations_by_city.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country_slug` | string | No | Country slug for the URL path (e.g. 'deutschland'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/avis/get-locations-by-country \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"country_slug":"<string>"}'
```

### Get vehicle list

Get the Avis Germany vehicle fleet listing, including vehicle groups, categories, example cars, descriptions, and specifications. Returns all vehicle groups available for rental in Germany.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/avis/get-vehicle-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search locations autocomplete

Search for Avis rental locations by name, city, or airport code. Returns matching stations with coordinates and basic details. Paginates as a single page; all matches for the query are returned at once.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search query such as a city name or airport code (e.g. 'Frankfurt', 'FRA', 'München'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/avis/search-locations-autocomplete \
  -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://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.