List events

Lists events, newest first: permits and cases filed on monitored places.

Events are listed whether or not a webhook takes them. Retrieve the record at data.href, which costs a credit.

Parameters

query

type"permit.created" | "case.created"[]: Only events of these types. Repeat for several.
min_createdstring | null: Only events created at or after this time, in ISO 8601.
cursorstring | null: A cursor for pagination: the next_cursor from the previous page.
sizeinteger | null: Number of results per page, between 1 and 200. Defaults to 20.

Responses

200: array of event objects; A page of events.
401: ProblemDetail; credential_missing, credential_invalid or credential_expired. The request has no valid credential.
403: ProblemDetail; scope_missing, person_required, api_key_not_accepted or entitlement_missing. The credential or plan does not allow this request. detail names the reason.
422: ProblemDetail; parameter_invalid, id_malformed or a cursor code. A parameter is missing or invalid. errors lists each one.
429: ProblemDetail; rate_limited. Too many requests. Retry after the Retry-After interval. Nothing is charged.

Credits

Free.

Example request

curl -X GET 'https://api.placestack.com/v1/event' \
  -H "Authorization: Bearer $PLACESTACK_API_KEY"

Example response

{
  "object": "list",
  "data": [
    {
      "object": "event",
      "id": "evt_01h455vb4pex5vsknk084sn02q",
      "type": "permit.created",
      "data": {
        "href": "/v1/permit/pmt_01h455vb4pex5vsknk084sn02q",
        "id": "pmt_01h455vb4pex5vsknk084sn02q",
        "list_item": "lsi_01h455vb4pex5vsknk084sn02q",
        "monitor": "mon_01h455vb4pex5vsknk084sn02q"
      },
      "created_at": "2026-09-13T12:00:00Z",
      "href": "/v1/event/evt_01h455vb4pex5vsknk084sn02q"
    }
  ],
  "has_more": true,
  "next_cursor": "eyJrIjoiMjAyNi0xMC0wMSIsInQiOjQyfQ",
  "suppressed": 0,
  "total": {
    "value": 1,
    "relation": "eq"
  }
}

Parameters

Responses

Credits

Next steps

GET /event/{event_id}