# Vergabe Rib — 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 tender information, award notices, and EU prior information from the RIB eVergabe platform to stay updated on procurement opportunities and contract awards. Get detailed tender specifications and the latest news to monitor bidding opportunities and market developments.

**Category:** Government & Public Data | **Website:** [vergabe.rib.de/](https://vergabe.rib.de/) | **Docs:** [parse.bot/marketplace/5b6f7466-5fe3-48f8-b239-1df3e833a69a/vergabe-rib-de-api](https://parse.bot/marketplace/5b6f7466-5fe3-48f8-b239-1df3e833a69a/vergabe-rib-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-vergabe-rib-de-api-5b6f7466/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_news

Retrieve news articles from the RIB eVergabe news section. Returns article titles, publication links, dates, and content summaries. Articles cover platform updates, feature announcements, and procurement industry developments.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of news articles to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vergabe-rib-de-api-5b6f7466/get_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### get_tender_details

Get detailed information for a specific tender by its ID. Returns dates and deadlines, procedure details (regulation, procedure type, lot subdivision), contracting authority contact, execution place, and CPV codes. The tender_id is obtained from search_tenders, search_eu_prior_information, or search_award_notices results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `tender_id` | string | Yes | The tender publication ID (numeric string). Obtainable from search_tenders results[*].id. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vergabe-rib-de-api-5b6f7466/get_tender_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tender_id":"<string>"}'
```

### search_award_notices

Search for Contract Award Notices (Vergabeinformationen). Returns a list of award notices with basic metadata. These document completed procurement procedures and their outcomes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vergabe-rib-de-api-5b6f7466/search_award_notices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### search_eu_prior_information

Search for EU Prior Information Notices (Vorinformationen). Returns a list of notices with basic metadata including title, contracting authority, and publication date. These are advance notices of planned procurement published under EU regulations.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vergabe-rib-de-api-5b6f7466/search_eu_prior_information \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### search_tenders

Search for tender publications (Bekanntmachungen) with optional filters for keyword, location, procedure type, and sort order. Returns paginated results ordered by publication date. Each result is a lightweight summary; use get_tender_details for full information including deadlines, CPV codes, and contracting authority contact.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return. |
| `location` | string | No | Location filter (city or region name, e.g. 'Berlin', 'München'). |
| `procedure_type` | string | No | Filter by procedure type. |
| `query` | string | No | Search keyword to filter tenders by title or description. |
| `radius` | string | No | Search radius in km around the specified location. |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-vergabe-rib-de-api-5b6f7466/search_tenders \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","location":"<string>","procedure_type":"<string>","query":"<string>","radius":"<string>","sort":"<string>"}'
```