/proposals
List proposals with optional filtering and pagination, sorted by their most recent meeting date (newest first). For text search, use GET /search instead.
API key as Bearer token
In: header
Query Parameters
101 <= value <= 50000 <= valueControls response detail level. summary: lightweight overview, fastest, ideal for result lists and quick searches. standard: richer data for displaying detailed cards or results. full: includes deeply nested fields, best for analysis or full context rendering.
"summary""summary" | "standard" | "full"Entity IDs (Regionalschlüssel) as repeated query params or comma-separated list. Use * suffix for prefix matching: 01* matches all from Schleswig-Holstein, 03101 matches Braunschweig exactly.
Include proposals whose most recent meeting is on or after this date (inclusive). A proposal can be scheduled on several meetings; the date of the latest one counts.
dateInclude proposals whose most recent meeting is on or before this date (inclusive).
dateOnly return proposals that carry the requested content, as repeated query params or comma-separated list. All requested values must be present. agendaItems: the proposal is scheduled on at least one meeting. documents: at least one PDF or ZIP document is available, on the proposal itself or on one of its agenda items. voting: at least one of its agenda items has a recorded voting outcome.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.poliscope.de/v2/proposals"{
"data": [
{
"id": "string",
"title": "string",
"reference": "string",
"documentCount": -9007199254740991,
"url": "string",
"description": "string",
"caseReference": "string",
"ris": {
"id": 0,
"status": "string",
"urls": [
"string"
],
"lastChecked": "2019-08-24T14:15:22Z",
"provider": {
"id": "string",
"name": "string"
},
"entities": [
{
"id": "string",
"name": "string",
"level": "10",
"location": {
"lat": 0,
"lon": 0
},
"parents": [
{
"id": "string",
"name": "string",
"level": "10"
}
]
}
]
},
"documents": [
{
"id": "string",
"type": "string",
"originalUrl": "string",
"file": {
"id": "string",
"fileName": "string",
"mimeType": "string",
"downloadUrl": "string"
}
}
],
"agendaItems": [
{
"id": "string",
"number": "string",
"title": "string",
"description": "string",
"url": "string",
"voting": {
"result": {
"yes": 0,
"no": 0,
"abstain": 0,
"recusal": 0,
"decision": "string",
"other": {
"property1": 0,
"property2": 0
}
},
"resolution": "string"
},
"documents": [
{
"id": "string",
"type": "string",
"originalUrl": "string",
"file": {
"id": "string",
"fileName": "string",
"mimeType": "string",
"downloadUrl": "string"
}
}
],
"meeting": {
"id": "string",
"title": "string",
"date": "2019-08-24T14:15:22Z",
"committee": "string",
"url": "string",
"location": {
"lat": 0,
"lon": 0
},
"documentCount": -9007199254740991,
"createdAt": "2019-08-24T14:15:22Z"
}
}
],
"externalId": "string"
}
],
"meta": {
"pagination": {
"total": 0,
"limit": 0,
"offset": 0
}
}
}{
"error": "BAD_REQUEST",
"message": "string"
}{
"error": "BAD_REQUEST",
"message": "string"
}{
"error": "BAD_REQUEST",
"message": "string"
}{
"error": "BAD_REQUEST",
"message": "string"
}