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

> Search and explore Austrian public procurement contracts, including details about contracting authorities, suppliers, and product categories. Track government spending by accessing comprehensive information about individual contracts, the organizations that issue them, and the vendors that supply them.

**Category:** Government & Public Data | **Website:** [offenevergaben.at/](https://offenevergaben.at/) | **Docs:** [parse.bot/marketplace/a796d0e9-aae5-4c71-89c3-19d054d68a7f/offenevergaben-at-api](https://parse.bot/marketplace/a796d0e9-aae5-4c71-89c3-19d054d68a7f/offenevergaben-at-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/offenevergaben/`
**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 contract detail

Fetch full details of a specific contract. Uses structured XML source when available, otherwise falls back to HTML parsing. Core fields (id, bezeichnung, auftraggeber, lieferant, art_des_auftrags) are consistently present; additional fields vary by contract type and data source.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Contract ID from list_contracts results (e.g. 280981). |

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

### Get contracting authority detail

Fetch profile and recent contracts of a contracting authority. Returns authority metadata including total volume, average bidders, and a list of their awarded contracts.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Authority ID from list_contracting_authorities results (e.g. 8476). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/offenevergaben/get-contracting-authority-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"id":"<string>"}'
```

### Get supplier detail

Fetch profile and awarded contracts of a supplier. Returns supplier metadata including total volume, contract count, and a list of contracts they were awarded.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Supplier ID from list_suppliers results (e.g. 8478). |

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

### List categories

Fetch the list of CPV (Common Procurement Vocabulary) industry categories with their contract counts and volumes. Returns all categories in a single response without pagination.

**Estimated cost:** Metered

_No parameters required._

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

### List contracting authorities

Fetch a paginated list of contracting authorities sorted by total contract volume descending. Returns 20 authorities per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/offenevergaben/list-contracting-authorities \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### List contracts

Fetch a paginated list of public contracts with optional filters. Returns 20 contracts per page sorted by last modification date descending. Supports filtering by keyword search, notice type, date range, contract type, volume range, bidder count, CPV code, and NUTS region.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `contract_types` | string | No | Contract types comma-separated (Bauauftrag, Dienstleistungsauftrag, Lieferauftrag). |
| `cpv` | string | No | CPV category code from list_categories (e.g. 45000000). |
| `date_from` | string | No | Start date in YYYY-MM-DD format. |
| `date_to` | string | No | End date in YYYY-MM-DD format. |
| `date_type` | string | No | Date field to filter by (e.g. date_lastmod). |
| `nuts` | string | No | Region NUTS codes comma-separated (e.g. AT130,AT342). |
| `page` | integer | No | Page number. |
| `search` | string | No | Keyword search for title, authority, or supplier. |
| `tenders_from` | integer | No | Minimum number of bidders. |
| `tenders_to` | integer | No | Maximum number of bidders. |
| `types` | string | No | Notice types comma-separated (Ausschreibung, Auftrag). |
| `volume_from` | number | No | Minimum contract volume. |
| `volume_to` | number | No | Maximum contract volume. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/offenevergaben/list-contracts \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"contract_types":"<string>","cpv":"<string>","date_from":"<string>","date_to":"<string>","date_type":"<string>","nuts":"<string>","page":"<integer>","search":"<string>","tenders_from":"<integer>","tenders_to":"<integer>","types":"<string>","volume_from":"<number>","volume_to":"<number>"}'
```

### List suppliers

Fetch a paginated list of suppliers sorted by total contract volume descending. Returns 20 suppliers per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/offenevergaben/list-suppliers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

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