Interruptions

Base URL: $BUSINESS_API

The object

idstring · required
tenant_idstring · required
titlestring · required
interruption_typestring · required

one of maintenance, emergency, rationing

statusstring · required

one of planned, active, completed, cancelled

service_area_idstring · required
dma_idstring · optional
descriptionstring · optional
start_timestring (date-time) · required
end_timestring (date-time) · required
affected_customers_estinteger · optional
created_atstring (date-time) · required
updated_atstring (date-time) · required
The object
{
  "id": "sup_2xVSEXVGkjH84PdmebPICxjIkZH",
  "tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
  "title": "Fuga na Rua 3",
  "interruption_type": "maintenance",
  "status": "planned",
  "service_area_id": "ser_23fmkpfkC17kSVJ2spjyiBbOED9",
  "dma_id": "dma_2gE3tiwbLQQnDGcrVkstPO8Bjkg",
  "description": "Leitura confirmada no local.",
  "start_time": "2026-11-19T09:30:00Z",
  "end_time": "2026-11-19T09:30:00Z",
  "affected_customers_est": 1,
  "created_at": "2026-11-19T09:30:00Z",
  "updated_at": "2026-11-19T09:30:00Z"
}

List water supply interruptions

Logs

GET /interruptions

Returns the tenant's planned and unplanned supply interruptions with type, status, service area, DMA, start and end times and estimated affected customers. Results are cursor-paginated (default 20, maximum 100); the handler also accepts service_area_id and status filters. Customers in an affected service area see open interruptions through the consumer API. Requires the interruptions:read permission.

Parameters

limitinteger · query · optional

Maximum resources to return (default 20, maximum 100).

afterstring · query · optional

Opaque cursor returned by the previous page.

Returns

200 Supply interruptions

Show attributes
dataarray of SupplyInterruption · required
Show child attributes
idstring · required
tenant_idstring · required
titlestring · required
interruption_typestring · required

one of maintenance, emergency, rationing

statusstring · required

one of planned, active, completed, cancelled

service_area_idstring · required
dma_idstring · optional
descriptionstring · optional
start_timestring (date-time) · required
end_timestring (date-time) · required
affected_customers_estinteger · optional
created_atstring (date-time) · required
updated_atstring (date-time) · required
has_moreboolean · optional
next_cursorstring · optional

Errors 403

Permissions interruptions:read · Roles: admin, analyst, customer_service, field_reader, field_supervisor, operations, owner, viewer

curl -X GET "$BUSINESS_API/interruptions" \
  -H "Authorization: Bearer sk_test_..."
Response 200
{
  "data": [
    {
      "id": "sup_2xVSEXVGkjH84PdmebPICxjIkZH",
      "tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
      "title": "Fuga na Rua 3",
      "interruption_type": "maintenance",
      "status": "planned",
      "service_area_id": "ser_23fmkpfkC17kSVJ2spjyiBbOED9",
      "dma_id": "dma_2gE3tiwbLQQnDGcrVkstPO8Bjkg",
      "description": "Leitura confirmada no local.",
      "start_time": "2026-11-19T09:30:00Z",
      "end_time": "2026-11-19T09:30:00Z",
      "affected_customers_est": 1,
      "created_at": "2026-11-19T09:30:00Z",
      "updated_at": "2026-11-19T09:30:00Z"
    }
  ],
  "has_more": true,
  "next_cursor": "next cursor"
}

Schedule a supply interruption

Logs

POST /interruptions

Creates a supply interruption with status planned and returns it with 201. title and service_area_id are required (400 otherwise); interruption_type defaults to maintenance (other values: emergency, rationing), and DMA, description, start and end times and an affected-customer estimate are optional. Open interruptions in an area become visible to that area's customers. Requires the operations:write permission.

Body application/json

titlestring · required
interruption_typestring · optional

one of maintenance, emergency, rationing

service_area_idstring · required
dma_idstring · optional
descriptionstring · optional
start_timestring (date-time) · optional
end_timestring (date-time) · optional
affected_customers_estinteger · optional

Returns

201 Supply interruption scheduled

Show attributes
idstring · required
tenant_idstring · required
titlestring · required
interruption_typestring · required

one of maintenance, emergency, rationing

statusstring · required

one of planned, active, completed, cancelled

service_area_idstring · required
dma_idstring · optional
descriptionstring · optional
start_timestring (date-time) · required
end_timestring (date-time) · required
affected_customers_estinteger · optional
created_atstring (date-time) · required
updated_atstring (date-time) · required

Errors 400 · 403

Permissions operations:write · Roles: admin, field_supervisor, operations, owner

curl -X POST "$BUSINESS_API/interruptions" \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
  "title": "Fuga na Rua 3",
  "interruption_type": "maintenance",
  "service_area_id": "ser_23fmkpfkC17kSVJ2spjyiBbOED9",
  "dma_id": "dma_2gE3tiwbLQQnDGcrVkstPO8Bjkg",
  "description": "Leitura confirmada no local.",
  "start_time": "2026-11-19T09:30:00Z",
  "end_time": "2026-11-19T09:30:00Z",
  "affected_customers_est": 1
}'
Response 201
{
  "id": "sup_2xVSEXVGkjH84PdmebPICxjIkZH",
  "tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
  "title": "Fuga na Rua 3",
  "interruption_type": "maintenance",
  "status": "planned",
  "service_area_id": "ser_23fmkpfkC17kSVJ2spjyiBbOED9",
  "dma_id": "dma_2gE3tiwbLQQnDGcrVkstPO8Bjkg",
  "description": "Leitura confirmada no local.",
  "start_time": "2026-11-19T09:30:00Z",
  "end_time": "2026-11-19T09:30:00Z",
  "affected_customers_est": 1,
  "created_at": "2026-11-19T09:30:00Z",
  "updated_at": "2026-11-19T09:30:00Z"
}

Get supply interruption details

Logs

GET /interruptions/{id}

Returns one supply interruption with its type, status, service area, DMA, schedule and estimated affected customers. Returns 404 when it is not in the tenant. Requires the interruptions:read permission.

Parameters

idstring · path · required

Identifier of the interruption (an out_ prefixed ID) within the current tenant.

Returns

200 Interruption details

Show attributes
idstring · required
tenant_idstring · required
titlestring · required
interruption_typestring · required

one of maintenance, emergency, rationing

statusstring · required

one of planned, active, completed, cancelled

service_area_idstring · required
dma_idstring · optional
descriptionstring · optional
start_timestring (date-time) · required
end_timestring (date-time) · required
affected_customers_estinteger · optional
created_atstring (date-time) · required
updated_atstring (date-time) · required

Errors 403 · 404

Permissions interruptions:read · Roles: admin, analyst, customer_service, field_reader, field_supervisor, operations, owner, viewer

curl -X GET "$BUSINESS_API/interruptions/{id}" \
  -H "Authorization: Bearer sk_test_..."
Response 200
{
  "id": "sup_2xVSEXVGkjH84PdmebPICxjIkZH",
  "tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
  "title": "Fuga na Rua 3",
  "interruption_type": "maintenance",
  "status": "planned",
  "service_area_id": "ser_23fmkpfkC17kSVJ2spjyiBbOED9",
  "dma_id": "dma_2gE3tiwbLQQnDGcrVkstPO8Bjkg",
  "description": "Leitura confirmada no local.",
  "start_time": "2026-11-19T09:30:00Z",
  "end_time": "2026-11-19T09:30:00Z",
  "affected_customers_est": 1,
  "created_at": "2026-11-19T09:30:00Z",
  "updated_at": "2026-11-19T09:30:00Z"
}

Mark supply restored

Logs

POST /interruptions/{id}/complete

Sets the interruption's status to completed and returns it, so it is no longer shown to customers as open. The current status is not checked, so a cancelled or already completed interruption is also set to completed. Returns 404 for an unknown interruption. Requires the operations:write permission.

Parameters

idstring · path · required

Identifier of the interruption to complete within the current tenant.

Returns

200 Interruption completed

Show attributes
idstring · required
tenant_idstring · required
titlestring · required
interruption_typestring · required

one of maintenance, emergency, rationing

statusstring · required

one of planned, active, completed, cancelled

service_area_idstring · required
dma_idstring · optional
descriptionstring · optional
start_timestring (date-time) · required
end_timestring (date-time) · required
affected_customers_estinteger · optional
created_atstring (date-time) · required
updated_atstring (date-time) · required

Errors 403 · 404

Permissions operations:write · Roles: admin, field_supervisor, operations, owner

curl -X POST "$BUSINESS_API/interruptions/{id}/complete" \
  -H "Authorization: Bearer sk_test_..."
Response 200
{
  "id": "sup_2xVSEXVGkjH84PdmebPICxjIkZH",
  "tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
  "title": "Fuga na Rua 3",
  "interruption_type": "maintenance",
  "status": "planned",
  "service_area_id": "ser_23fmkpfkC17kSVJ2spjyiBbOED9",
  "dma_id": "dma_2gE3tiwbLQQnDGcrVkstPO8Bjkg",
  "description": "Leitura confirmada no local.",
  "start_time": "2026-11-19T09:30:00Z",
  "end_time": "2026-11-19T09:30:00Z",
  "affected_customers_est": 1,
  "created_at": "2026-11-19T09:30:00Z",
  "updated_at": "2026-11-19T09:30:00Z"
}