Skip to main content
GET
Read news for a monitor

Authorizations

Authorization
string
header
required

Itoflow access token issued for the Itoflow API.

Path Parameters

id
string<uuid>
required

Monitor UUID

Query Parameters

limit
integer
default:200

Maximum items to return, from 1 to 200.

Required range: 1 <= x <= 200
since
string<date-time>

Return only items with a holding or mandate match judged after this time, newest first, each with all its matches. The read reaches 5 minutes before this time to catch matches that were saved late, so merge items by id. A page that comes back with limit items may have left older ones out, so read once without since instead. Use ISO 8601 with a zone, such as 2026-09-25T12:00:00Z.

Response

News feed

feed
object
required
items
object[]
required

Items that reach a holding or match the mandate. Without since, the top items by the default score, where a mandate match scores as a holding with materiality mandate_p × impact and weight 0, and an item matched both ways takes the larger score; with since, items with a holding pair or a mandate match judged after 5 minutes before it, newest first, each with all its matches. Mandate matches show only when they were judged for the current mandate text.