PoliscopePoliscope
APIReferenzEntities

/entities

GET
/entities

List entities with optional filtering and pagination

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"
q?string

Filter by name (case-insensitive substring match)

ids?string

Comma-separated list of entity IDs (Regionalschlüssel) to fetch. When provided, only entities with matching IDs are returned.

level?string

Filter by administrative level

Value in"10" | "40" | "50" | "60" | "pr"
parentId?string

Filter by parent entity ID (Regionalschlüssel)

stateId?string

Filter by Bundesland ID (Regionalschlüssel)

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://api.poliscope.de/v2/entities"
{
  "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": "string",
        "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": {
    "pagination": {
      "total": 0,
      "limit": 0,
      "offset": 0
    }
  }
}
{
  "error": "string",
  "message": "string"
}
{
  "error": "string",
  "message": "string"
}
{
  "error": "string",
  "message": "string"
}