To get a list of individuals updated since yesterday in the ChMS API v2, use the POST /search/individuals/results endpoint with the appropriate filters.

Endpoint Details

Method: POST URL: /search/individuals/results

Request Body Structure

{
    "configuration": {
        "columns": [
            "date_modified"
        ],
        "order_by": [
            {
                "column": "date_modified",
                "direction": "asc"
            }
        ],
        "filter_profile_type": [
            "active"
        ],
        "include_unlisted": true,
        "include_lau": true,
        "include_pending": true,
        //Note: returning other family positions may be outside of filter criteria.
				//"return_family_positions": [   "PRIMARY_CONTACT"],				
        "return_search_results": true
    },
    "filters": {
        "type": "group",
        "operator": "and",
        "inverted": false,
        "conditions": [
            {
                "type": "constraint",
                "id": "date_modified",                
                "operator": "greater_than",
                "value": "2025-12-01",
                "inverted": false
            },
            {
                "type": "constraint",
                "id": "date_modified",                
                "operator": "less_than",
                "value": "2025-12-31",
                "inverted": false
            }
        ]
    }
}

Key Points

Search Endpoint

Use the advanced search endpoint /search/individuals/results rather than the basic GET /individuals endpoint, as it provides filtering capabilities.

Modified Date Filter

The date_modified in the filters object allows you to specify a date range. You can set:

start: Yesterday's date (in YYYY-MM-DD format)
end: Today's date

Response Includes Metadata

The search results return IndividualDetailsSerializer objects which include modified timestamp metadata showing when each individual was last updated.

    {
        "id": 314,
        "campus_id": 3,
        "campus_name": "St Luke's Campus",
        "family_id": 1622,
        "created": "2025-12-03T15:53:42-07:00",
        "modified": "2025-12-03T15:54:08-07:00",

Pagination

Use query parameters to page through the results:

page (default: 1)
per_page (default: 25; options: 25, 50, 75, 100)

Required Scope(s)

You'll need the read:advanced_searches OAuth2 scope for this endpoint.

Response Headers

The response includes pagination metadata:

Key	Description
X-Page	Current page number
X-Per-Page	Results per page
X-Total-Pages	Total pages available
X-Offset	Offset from the start