# Vergabe Rib — 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 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/vergabe-rib/`
**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 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.beta.paywithlocus.com/api/wrapped/credits/vergabe-rib/get-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/vergabe-rib/get-tender-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/vergabe-rib/search-award-notices \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/vergabe-rib/search-eu-prior-information \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/vergabe-rib/search-tenders \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","location":"<string>","procedure_type":"<string>","query":"<string>","radius":"<string>","sort":"<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.