# Evergabe Online — 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 retrieve public tender opportunities from Germany's e-Vergabe platform by keywords, contract types, CPV codes, and publication dates. Access detailed tender information and discover the latest procurement opportunities across construction and other sectors.

**Category:** Government & Public Data | **Website:** [evergabe-online.de/](https://evergabe-online.de/) | **Docs:** [parse.bot/marketplace/6d071c48-ffec-48e6-b04e-a7d0fdf29f25/evergabe-online-de-api](https://parse.bot/marketplace/6d071c48-ffec-48e6-b04e-a7d0fdf29f25/evergabe-online-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/evergabe-online/`
**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 latest tenders

Retrieve the most recently published tenders from the last 7 days. Returns up to 10 tender summaries sorted by publication date. No input parameters required.

**Estimated cost:** Metered

_No parameters required._

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

### Get tender details

Retrieve full details of a specific tender by its ID. Returns structured procurement information including contracting authority details, deadlines, reference number, CPV codes, and submission requirements. The response includes both standard fields (title, dates, authority) and variable document sections parsed from the tender's structured content.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | The tender ID from search results. |

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

### Search construction tenders

Search specifically for construction (Bauauftrag/WORKS) tenders. Equivalent to search_tenders with contract_type=WORKS pre-applied. Returns up to 10 results per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `keywords` | string | No | Search keywords to match against tender title, description, and other fields. |
| `page` | integer | No | Page number for pagination. |
| `publish_date_range` | string | No | Relative publication period filter. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/evergabe-online/search-construction-tenders \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"keywords":"<string>","page":"<integer>","publish_date_range":"<string>"}'
```

### Search tenders

Full-text search over public tenders on the e-Vergabe platform. Matches keywords against title, description, and metadata. Filters by contract type and publication date range. Returns up to 10 results per page. Each tender summary includes id, title, reference number, contracting authority, location, procedure type, deadline, and publication date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `contract_type` | string | No | Filter by contract type. |
| `keywords` | string | No | Search keywords to match against tender title, description, and other fields. |
| `page` | integer | No | Page number for pagination. |
| `publish_date_range` | string | No | Relative publication period filter. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/evergabe-online/search-tenders \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"contract_type":"<string>","keywords":"<string>","page":"<integer>","publish_date_range":"<string>"}'
```

### Search tenders by cpv

Search tenders by CPV (Common Procurement Vocabulary) classification code. CPV codes categorize procurement subjects (e.g. 45000000 for construction work, 71000000 for architectural services). Returns up to 10 matching tender summaries.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cpv_code` | string | Yes | CPV classification code (e.g. 45000000 for construction work, 71000000 for architectural services). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/evergabe-online/search-tenders-by-cpv \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"cpv_code":"<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.