# Evergabe Online — 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 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-evergabe-online-de-api-6d071c48/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-evergabe-online-de-api-6d071c48/get_latest_tenders \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-evergabe-online-de-api-6d071c48/get_tender_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-evergabe-online-de-api-6d071c48/search_construction_tenders \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-evergabe-online-de-api-6d071c48/search_tenders \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-evergabe-online-de-api-6d071c48/search_tenders_by_cpv \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cpv_code":"<string>"}'
```