Siren

Get Note Position

Look up which page of a source's activity feed a specific note sits on.

Get Note Position

GET /siren/v1/notes/{id}/position

Returns the offset and total count for a specific note within a source’s unfiltered activity feed. Use this when you have a note ID (for example, from a deep link or a notification) and need to jump to the page of the feed that contains it.

Path Parameters:

ParameterTypeDescription
idintegerThe note ID

Query Parameters:

ParameterTypeDefaultDescription
sourceTypestringrequiredThe source to compute the position against.
sourceIdintegerrequiredThe source ID.
orderstringdescSort direction the caller is using. Must match the order used in the corresponding list request.

Example Request:

GET /siren/v1/notes/904/position?sourceType=conversion&sourceId=118&order=desc

Example Response:

{
  "offset": 0,
  "total": 7
}

Pair this with a list request using the same number per page to calculate which page of the feed to load:

page = floor(offset / number)