/meetings

List meetings with optional filtering and pagination. For text search, use GET /search instead.

Authorization

AuthorizationBearer <token>

API key as Bearer token

In: header

Query Parameters

limit?number

Default10

Range1 <= value <= 500

offset?number

Default0

Range0 <= value

detail?string

Controls 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.

Default"summary"

Value in"summary" | "standard" | "full"

entityIds?|array<>

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.

dateFrom?string

Filter meetings from this date (inclusive)

Formatdate

dateTo?string

Filter meetings up to this date (inclusive)

Formatdate

has?|array<>

Only return meetings that carry the requested content, as repeated query params or comma-separated list. All requested values must be present. agendaItems: the agenda has been published. documents: at least one PDF or ZIP document is available, on the meeting itself or on one of its agenda items. voting: at least one agenda item has a recorded voting outcome.

sort?string

Chronological order: -date returns the most recent meeting first, date the earliest. Use date together with dateFrom to page through upcoming meetings.

Default"-date"

Value in"date" | "-date"

Response Body

`application/json`

curl -X GET "https://api.poliscope.de/v2/meetings"

{
  "data": [
    {
      "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",
      "venue": "string",
      "description": "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"
              }
            ]
          }
        ]
      },
      "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"
              }
            }
          ],
          "externalId": "string",
          "proposals": [
            {
              "id": "string",
              "title": "string",
              "reference": "string",
              "documentCount": -9007199254740991,
              "url": "string"
            }
          ]
        }
      ],
      "documents": [
        {
          "id": "string",
          "type": "string",
          "originalUrl": "string",
          "file": {
            "id": "string",
            "fileName": "string",
            "mimeType": "string",
            "downloadUrl": "string"
          }
        }
      ],
      "bookmarks": [
        {
          "id": "string",
          "firstName": "string",
          "lastName": "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"
}

/meetings

Authorization

Query Parameters

Response Body

200application/json

400application/json

401application/json

403application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`