SAP Knowledge Base Article - Public

2245745 - Adhoc API throws [EXCEPTION] Exception=[SFAPI Domain Error!] Error Code=[THROTTLE_VIOLATION]


This document is to understand the cause of the throttling error and to prevent it from occurring.

The error "[EXCEPTION] Exception=[SFAPI Domain Error!] Error Code=[THROTTLE_VIOLATION] Error Message=[Throttle violation! Detail:Query request doesn't satisfy the throlling rule [Amount of Running and Waiting to run Jobs should less than or equal to [5]]]" may appear in Boomi / PI or wherever the SFAPI Adhoc entities are utilized.



Reproducing the Issue



In SFAPI, we have a limit per company instance that we can't have more than 5 jobs which are in waiting/running status. These Jobs are run in the SF Datacenter servers. If many jobs are submitted (More than 5) in the server for one company, this error would occur.

Example would be -

If you have already submitted 5 jobs for one company and if those jobs are in running/waiting status, once you prepare to submit the sixth job; you would encounter the throttling error. This is not a bug. This is to maintain the stability of Quartz server.



Once the running jobs reach the status “Completed” and if the currently running/waiting jobs are less than 5, new jobs have to be submitted.

To check the job status, go to Provisioning -> Monitor Jobs.

Note: You may need assistance from your implementation partner to access Provisioning system. If you do not have implementation partner reach out to SuccessFactors support team.

The jobs submitted by the SFAPI start with the prefix SFAPI_, please check the status of the jobs. Running sfapi jobs are the jobs whose status is 'Started' or 'In Progress' and job name starts with 'SFAPI_'

2019-08-07 05_42_59-Engineer Assistant.png

See Also

Important Note

We do not increase the parameter from 5. It is not recommended as it leads to dramatic issues if the threshold is too big.


Throttling error Throttle violation , KBA , LOD-SF-INT-API , API & Adhoc API Framework , LOD-SF-INT , Integrations , How To


SAP SuccessFactors HXM Suite all versions