GET /status/notices

Endpoint

GET /partner/status/notices

Authentication

None — public endpoint. It is designed to stay reachable during outages: on any internal error it still returns HTTP 200 with an empty list. A query parameter that is not a UUID is your error and answers 422.

Query parameters

Parameter	Type	Required	Description
`service_provider_id`	UUID	No	Your provider. Returns your notices plus the network-wide ones — those with no provider of their own, such as a building outage that hits every ISP on the switch. Without it, only the network-wide notices come back
`building_id`	UUID	No	Subscriber’s building — includes notices targeted at that building
`service_area_id`	UUID	No	Subscriber’s service area — includes notices targeted at that area

Scoping: a notice with no building/area targets is global and is always returned. Targeted notices are only returned when your building_id / service_area_id matches one of the notice’s targets — without context you only see global notices. Only active notices inside their display window (starts_at <= now <= ends_at, nulls open-ended) are returned.

Response — 200 OK

{
  "notices": [
    {
      "id": "uuid",
      "title": "Planned maintenance",
      "message": "string",
      "body": "string (alias of message)",
      "notice_type": "maintenance",
      "starts_at": "2026-07-01T22:00:00Z",
      "ends_at": "2026-07-02T02:00:00Z",
      "is_active": true,
      "resolved_at": null,
      "service_provider_id": "uuid"
    }
  ]
}

body and resolved_at are derived aliases: body mirrors message; resolved_at is null while the notice is active and equals ends_at once it isn’t. service_provider_id is null for a network-wide notice. A notice does not list its targets: which buildings or areas it covers is decided on kurnl’s side by the scoping above. On an internal error the endpoint degrades gracefully to { "notices": [] } with HTTP 200.

Overview

Plan Discovery

Provisioning

Reports

Checkout Utilities

Subscribers & Subscriptions

AI Support Agent

Provider Operations (Internal API)

Endpoint

Authentication

Query parameters

Response — 200 OK

​Endpoint

​Authentication

​Query parameters

​Response — 200 OK

Endpoint

Authentication

Query parameters

Response — 200 OK