SAP Knowledge Base Article - Public

3709085 - How to Query only Modified Users using SCIM API - SuccessFactors SCIM API

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

Product

SAP SuccessFactors HCM Suite all versions