PoliscopePoliscope
APIReferenzEntities

/entities/ris-coverage

GET
/entities/ris-coverage

RIS coverage report for entities matched by Regionalschlüssel patterns. Classifies each entity as good (active RIS with meetings in the last 3 months), degraded (RIS in review, uncrawlable, draft, paused, or without recent meetings), bad (no RIS despite being self-governing, or archived RIS) or notApplicable (not self-governing). Shares are calculated over rated entities only (notApplicable excluded).

AuthorizationBearer <token>

API key as Bearer token

In: header

Query Parameters

entityIds*|array<>

Regionalschlüssel patterns as repeated query params or comma-separated list. A trailing * matches by prefix (e.g. "01*" for all of Schleswig-Holstein), values without * match exactly.

includeNotApplicable?string

Include entities that need no RIS (selfGoverning=false) as the notApplicable group. Off by default: they never affect the shares, and a broad selection would return thousands of extra rows.

Defaultfalse

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://api.poliscope.de/v2/entities/ris-coverage?entityIds=string"
{
  "data": {
    "summary": {
      "totalEntities": 0,
      "ratedEntities": 0,
      "counts": {
        "good": 0,
        "degraded": 0,
        "bad": 0,
        "notApplicable": 0
      },
      "shares": {
        "good": 0,
        "degraded": 0,
        "bad": 0
      }
    },
    "entities": {
      "good": [
        {
          "id": "string",
          "name": "string",
          "level": "10",
          "status": "good",
          "reason": "activeWithRecentMeetings",
          "ris": {
            "id": 0,
            "status": "string"
          },
          "recentMeetingCount": 0
        }
      ],
      "degraded": [
        {
          "id": "string",
          "name": "string",
          "level": "10",
          "status": "good",
          "reason": "activeWithRecentMeetings",
          "ris": {
            "id": 0,
            "status": "string"
          },
          "recentMeetingCount": 0
        }
      ],
      "bad": [
        {
          "id": "string",
          "name": "string",
          "level": "10",
          "status": "good",
          "reason": "activeWithRecentMeetings",
          "ris": {
            "id": 0,
            "status": "string"
          },
          "recentMeetingCount": 0
        }
      ],
      "notApplicable": [
        {
          "id": "string",
          "name": "string",
          "level": "10",
          "status": "good",
          "reason": "activeWithRecentMeetings",
          "ris": {
            "id": 0,
            "status": "string"
          },
          "recentMeetingCount": 0
        }
      ]
    }
  },
  "meta": {}
}
{
  "error": "BAD_REQUEST",
  "message": "string"
}
{
  "error": "BAD_REQUEST",
  "message": "string"
}
{
  "error": "BAD_REQUEST",
  "message": "string"
}