List Notes for a Source

GET /siren/v1/notes

Returns the activity feed for a single source record — every note linked to the given sourceType / sourceId pair, in chronological order. Results are wrapped by the ListResponseWrapperInterceptor.

Query Parameters:

Parameter	Type	Default	Description
`sourceType`	string	required	The entity type to fetch notes for (for example, `collaborator`, `obligation`, `conversion`, `fulfillment`, `payout`, `engagement`, `transaction`).
`sourceId`	integer	optional	The entity ID. Omit to retrieve every note of the given `sourceType` across the install.
`fields`	string	`id,renderedContent,creationSource,dateCreated`	Comma-separated list of fields to include. Extended fields (`renderedContent`, `sourceData`, `sources`) only resolve when requested here.
`search`	string	—	Free-text search. Matches against the resolved blueprint content.
`from`	string	—	ISO-8601 datetime. Lower bound on `dateCreated`.
`to`	string	—	ISO-8601 datetime. Upper bound on `dateCreated`.
`number`	integer	20	Results per page
`offset`	integer	0	Pagination offset
`order`	string	`DESC`	Sort direction: `ASC` or `DESC`, always on `dateCreated`.

Response Headers:

x-siren-estimated-count. Total matching records (exposed via Access-Control-Expose-Headers).

Example Request:

GET /siren/v1/notes?sourceType=conversion&sourceId=118&fields=id,renderedContent,creationSource,dateCreated&number=25

Example Response:

[
  {
    "id": 904,
    "renderedContent": "Conversion #118 approved",
    "creationSource": "conversion",
    "dateCreated": "2026-04-14T17:02:11+00:00"
  },
  {
    "id": 903,
    "renderedContent": "Conversion #118 awarded — saleTransactionPercentage",
    "creationSource": "transaction",
    "dateCreated": "2026-04-14T16:58:42+00:00"
  }
]

Custom formatting:

Request sourceData and sources instead of renderedContent when you want to build your own display. content holds the raw blueprint key (for example, conversion_approved), sourceData is the data array the blueprint was resolved against, and sources is the list of {sourceType, sourceId} links for the note.

GET /siren/v1/notes?sourceType=conversion&sourceId=118&fields=id,content,sourceData,sources,dateCreated