Siren

List Conversions

Retrieve a paginated list of conversions with filtering and field selection.

Last updated: April 9, 2026

List Conversions

GET /siren/v1/conversions

Returns a paginated list of conversions. Results are wrapped by the ListResponseWrapperInterceptor.

Query Parameters

ParameterTypeDefaultDescription
statusstring—Filter by status
engagementIdinteger—Filter by engagement ID
typestring—Filter by conversion type
obligationIdinteger—Filter by obligation ID
transactionIdinteger—Filter by transaction ID
fieldsstringcore fieldsComma-separated list of fields to include
includestring—Legacy: extended to include extra fields
numberinteger10Results per page
offsetinteger0Pagination offset
orderBystringidSort field. Allowed: id, engagementId, type, status, dateCreated
orderstringDESCSort direction: ASC or DESC

Response Headers

The response includes an x-siren-estimated-count header with the total matching record count, exposed via Access-Control-Expose-Headers.

Example Request

GET /siren/v1/conversions?status=pending&fields=id,status,type,collaboratorId&number=25

Example Response

[
  {
    "id": 42,
    "status": "pending",
    "type": "sale",
    "collaboratorId": 7
  }
]