Gets Scheme engagements via pagination

GET https://{tenant}.rubixx.app/api/v2/supportschemes/{supportSchemeReference}/engagements

Sample Request:

GET /api/v2.0/supportschemes/SP1000000004/engagements?page=1&limit=25&filter=Ended

Sample Response:
{
    "data": [
        {
            "engagementId": "34917041-309f-4dc6-51be-08dc3ac7cd66",
            "schemeName": "St Paul's",
            "schemereference": "SP0000000004",
            "engagementReference": "SE1000000000",
            "engagementOwner": null,
            "personName": "Joseph Smith",
            "status": "Ended",
            "occupancyReference": null,
            "address": "The Old Queen's Head, 4 Main St, Witton Park, DL14 0DY",
            "startDate": "02/03/2024",
            "endDate": null,
            "safeToTalkWord": null,
            "notSafeToTalkWord": null            
        },
        ...
        ...
    ],
    "page": 1,
    "total": 1,
    "limitPerPage": 25,
    "totalFilteredEntries": 0,
    "totalEntries": 1
}

Filters are "Active" - "Ended" - "Suspended" and they are case sensitive
Null filter parameter returns all data

MAX PER PAGE LIMIT: 500

Required Permission(s): SupportPlans.View