PoliscopePoliscope
APIReferenzEntities

/entities/{id}

GET
/entities/{id}

Get a single entity by Regionalschlüssel (id)

Authorization

AuthorizationBearer <token>

API key as Bearer token

In: header

Path Parameters

id*string
Length1 <= length

Query Parameters

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"standard"
Value in"summary" | "standard" | "full"

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.poliscope.de/v2/entities/string"
{
  "data": {
    "id": "string",
    "name": "string",
    "level": "10",
    "location": {
      "lat": 0,
      "lon": 0
    },
    "parents": [
      {
        "id": "string",
        "name": "string",
        "level": "10"
      }
    ],
    "population": 100000000,
    "area": 0,
    "postalCode": "string",
    "city": "string",
    "street": "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"
            }
          ]
        }
      ]
    },
    "parent": "string",
    "state": "string",
    "weblinks": [
      {
        "url": "string",
        "title": "string",
        "description": "string",
        "domain": "string",
        "type": "string"
      }
    ],
    "aiSummary": "string",
    "aiSummaryDate": "2019-08-24T14:15:22Z"
  },
  "meta": {}
}
{
  "error": "BAD_REQUEST",
  "message": "string"
}
{
  "error": "BAD_REQUEST",
  "message": "string"
}
{
  "error": "BAD_REQUEST",
  "message": "string"
}
{
  "error": "BAD_REQUEST",
  "message": "string"
}

/entities GET

List entities with optional filtering and pagination

/entities/ris-coverage GET

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