Siren

Get Engagement

Retrieve a single engagement by ID with optional field selection.

Last updated: April 9, 2026

Get Engagement

GET /siren/v1/engagements/{id}

Returns a single engagement by ID.

Query Parameters:

ParameterTypeDefaultDescription
fieldsstringcore fieldsComma-separated list of fields to include
includestringLegacy: extended for all available fields

Example Request:

GET /siren/v1/engagements/91?fields=id,status,score,programName,collaboratorName

Example Response:

{
  "id": 91,
  "status": "active",
  "score": 100,
  "programName": "Affiliate Program",
  "collaboratorName": "Jane Smith"
}

Error Responses:

  • 404. No record found with that ID.
  • 500. Database error.