Filter to select and return only the employees that have been updated after updated_since. When it is used together with the attributes[] query parameter, the filter will select only the employees that have had any of the provided attributes[] updated since updated_since. The format is ISO 8601 (2022-12-24T08:15:30) or YYYY-MM-DD. NOTE: when using the updated_since filter, the email, limit, and offset parameters are ignored.
Examples with updated_since and attributes[]:
In an example company that has 17 employees:
?updated_since=2022-12-24T08:15:30
will yield 10 employees that were recently updated:
{
"success": true,
"metadata": {
"total_elements": 10,
"current_page": 0,
"total_pages": 10
},
"offset": 0,
"limit": 1,
"data": [
{
"type": "Employee",
"attributes": {
"id": {
"label": "ID",
"value": 1,
"type": "integer",
"universal_id": "id"
},
"first_name": {
"label": "First name",
"value": "Alexander",
"type": "standard",
"universal_id": "first_name"
},
"last_name": {
"label": "Last name",
"value": "Bergmann",
"type": "standard",
"universal_id": "last_name"
},
"email": {
"label": "Email",
"value": "[email protected]",
"type": "standard",
"universal_id": "email"
}
}
}, ...
],
...
...
}
?attributes[]=first_name
will yield all 17 employees:
{
"success": true,
"metadata": {
"total_elements": 17,
"current_page": 0,
"total_pages": 17
},
"offset": 0,
"limit": 1,
"data": [
{
"type": "Employee",
"attributes": {
"id": {
"label": "ID",
"value": 1,
"type": "integer",
"universal_id": "id"
},
"first_name": {
"label": "First name",
"value": "Alexander",
"type": "standard",
"universal_id": "first_name"
}
}
}
]
}
?attributes[]=first_name&updated_since=2022-12-24T08:15:30
will yield 3 employees, ones that had their first_name changed since 2022-12-24T08:15:30:
{
"success": true,
"metadata": {
"total_elements": 3,
"current_page": 0,
"total_pages": 3
},
"offset": 0,
"limit": 1,
"data": [
{
"type": "Employee",
"attributes": {
"id": {
"label": "ID",
"value": 1,
"type": "integer",
"universal_id": "id"
},
"first_name": {
"label": "First name",
"value": "Alexander",
"type": "standard",
"universal_id": "first_name"
}
}
}
]
}
