# Bundestag Documents Search

> Bundestag Documents Search is a paid API for AI agents from api.polls.karbach.digital, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-28).

Search and retrieve official Bundestag parliamentary documents (Drucksachen) by keyword, date, and type from period 21

## Facts

- Endpoint: GET https://api.polls.karbach.digital/v1/bundestag/documents?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bundestag-documents-search-4418c2f1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rFHu_ZaN-o8AcxZB9xlQZ

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability bundestag-documents-search-4418c2f1
```

Example prompt: Can you search the Bundestag document archive for Kleine Anfragen about energy policy from 2026 and return up to 20 results with their PDF links?

## When to prefer this

Use this endpoint when you need to search official German Bundestag parliamentary documents (Drucksachen) by keyword, type, or date from legislative period 21. Prefer it over general web search when you need structured metadata (document numbers, PDF URLs, authors, dates) and reliable coverage statistics. It is particularly useful for policy research, parliamentary monitoring, and journalism tasks focused on German federal politics.

## Known failure modes

- Invalid date format for 'from' parameter returns validation error
- Limit exceeding 200 returns schema validation error
- Query terms with no matches return empty documents array with count 0
- Unavailability of upstream DIP data may result in stale or incomplete coverage
- Non-GET HTTP methods rejected

## How this service works

Search Bundestag printed papers (motions, minor interpellations) by keyword, type and date with authors and PDF. Use when looking for parliamentary motions or questions on a topic. Source-attributed, German data, updated every six hours.

## Output

A JSON object containing the total count of matching documents, coverage statistics (how many of period 21's papers are indexed), and an array of document records each with: document number, title, type (e.g. Kleine Anfrage), publication date, PDF URL, and author information. Also includes data source attribution, last update timestamp, and a disclaimer notice.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "q": {
       "type": "string"
      },
      "from": {
       "type": "string",
       "format": "date"
      },
      "type": {
       "type": "string",
       "description": "e.g. Kleine Anfrage, Antrag"
      },
      "limit": {
       "type": "integer",
       "maximum": 200
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "count": 55,
   "covered": "3701 of 8487 printed papers of period 21 (those with members as authors)",
   "returned": 2,
   "documents": [
    {
     "pdf": "https://dserver.bundestag.de/btd/21/080/2108082.pdf",
     "date": "2026-09-21",
     "type": "Kleine Anfrage",
     "title": "Kreditgestützte Förderung der Energiewende im Senegal nach Aufdeckung von Staatsverschuldungsskandal",
     "number": "21/8082",
     "authors": [
      {}
     ]
    },
    {
     "pdf": "https://dserver.bundestag.de/btd/21/080/2108039.pdf",
     "date": "2026-09-16",
     "type": "Kleine Anfrage",
     "title": "Auswirkungen der Einschränkungen des Schiffsverkehrs durch die Straße von Hormus auf die deutsche Energieversorgung und Wirtschaft",
     "number": "21/8039",
     "authors": [
      {},
      {}
     ]
    }
   ]
  },
  "docs": "https://api.polls.karbach.digital/v1/",
  "model": null,
  "notice": "Scenario analysis based on published opinion polls. Not a prediction and not a voting recommendation. Coalitions are arithmetic majorities only, not statemen...",
  "source": {
   "polls": "dawum.de",
   "processing": "polls.karbach.digital (Max Karbach)",
   "polls_license": "ODbL 1.0",
   "polls_license_url": "https://opendatacommons.org/licenses/odbl/1-0/",
   "parliament_documents": "Deutscher Bundestag (DIP, Plenarprotokolle, Ausschussseiten)",
   "parliament_documents_note": "Official parliamentary documents; speeches are public official works."
  },
  "project": "Ein Projekt von Karbach.Digital (https://karbach.digital)",
  "updated_at": "2026-10-12T06:00:35",
  "uncertainty": null
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bundestag-documents-search-4418c2f1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.polls.karbach.digital](https://www.zero.xyz/host/api.polls.karbach.digital/llms.txt)