Symptom
When consuming the SAP SuccessFactors SCIM 2.0 API, customers often need to retrieve only users that were modified after a specific point in time, instead of fetching the entire user base on every API call. This is especially important for incremental synchronization scenarios, performance optimization, and downstream system integrations.
The question is: Is it possible to query only modified user records using the SuccessFactors SCIM 2.0 API?
Environment
- SAP SuccessFactors HCM Suite
- SuccessFactors SCIM API
Resolution
Yes. The SAP SuccessFactors SCIM 2.0 API supports filtering user records based on their last modification timestamp by using the meta.lastModified attribute.
You can leverage the SCIM filter parameter to return only users whose records were updated after a given date and time.
Example Request
Use the following pattern to retrieve users modified after a specific timestamp:
GET {{api-server}}/rest/iam/scim/v2/Users?filter=meta.lastModified gt "yyyy-mm-ddThh:mm:ssZ"
Example with a Real Timestamp
This request will return all user records whose meta.lastModified value is greater than the specified UTC timestamp.
GET https://api.example.com/rest/iam/scim/v2/Users?filter=meta.lastModified gt "2026-01-01T00:00:00Z"
Additional Information
- The timestamp must be provided in UTC and follow the ISO 8601 format (yyyy-mm-ddThh:mm:ssZ).
- The meta.lastModified attribute is automatically maintained by the SCIM service and reflects the most recent update to the user record.
- This approach is recommended for:
- Delta/incremental user synchronization
- Reducing payload size and API load
- Improving integration performance
By using the meta.lastModified filter, the SuccessFactors SCIM 2.0 API allows efficient querying of only modified user records, enabling incremental data synchronization without the need to process the full user dataset on each request.
See Also
Keywords
SCIM API, version 2, delta API calls, lastModified, RFC 7643, SAP SuccessFactors, user provisioning, identity lifecycle management, ILM integration, error handling, API filter, metadata handling, optional attributes. , KBA , LOD-SF-INT-API , API & Adhoc API Framework , Problem
SAP Knowledge Base Article - Public