Events

Get a list of events

Changed on

Return a page of events from the stream.

Supports cursor-based pagination with an optional entity filter and timestamp lower bound. The stream starts on 22 April 2026 and, in production, also carries the earlier lifecycle of every holding open on that date. For holdings closed before then, use the holdings and subscriptions endpoints.

get/event

Request

  • Base URL
    https://api.treasuryspring.com/api/v1
  • Auth
    HTTP bearer

Query parameters

entity_codestring nullable

Only return events for this entity. Requires permission to view the entity's holdings. Cursors are positions in the whole stream, so keep a separate cursor or checkpoint for each filter you sync with.

start_cursorstring nullable

Return events after this cursor (exclusive)

end_cursorstring nullable

Return events up to and including this cursor

min_created_atstring date-time nullable

Return events created at or after this timestamp. ISO 8601 datetime in any timezone. When using a timezone offset, percent-encode the + as %2B (e.g. %2B01:00), or use the Z suffix for UTC.

limitinteger

Max events to return

Response

Event stream with pagination

Example response

{
  "events": [
    {
      "cost": "10000.00",
      "currency": "GBP",
      "cursor": "ev1.abc123.xyz789",
      "entityCode": "TEST001",
      "ftfType": "Fixed",
      "holdingUid": "6e69e21342a24bbdaf9fe4e8a9995fda",
      "maturityDate": "2025-01-01",
      "maturityValue": "10250.00",
      "obligorExposureCode": "BACR",
      "productCode": "GBP-BACR[GC]-3M",
      "subscriptionDate": "2024-01-01",
      "subscriptionUid": "dade0389c66241bd8366b017f1ffe19a",
      "uid": "00000000000000000000000000000001",
      "yield": "4.000000"
    }
  ],
  "pageInfo": {
    "endCursor": "ev1.abc123.xyz789",
    "limit": 1000,
    "pageEndCursor": "ev1.abc123.xyz789",
    "startCursor": "ev1.abc123.xyz789",
    "totalCount": 42
  }
}

Changes

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the new optional query request parameter entity_code