API V2

Introduction keyboard_arrow_down

Request Limits

To ensure fair usage and maintain system stability, our API enforces the following rate limits:


  • Per API Key: A maximum of 300 API calls per 60 seconds.
  • Per Organization: A maximum of 2,400 API calls per 60 seconds (aggregated across all users within the same organization).

If these limits are exceeded, additional requests will be temporarily blocked, and an HTTP 429 Too Many Requests response will be returned. We recommend implementing exponential backoff and retry mechanisms to handle rate limit errors effectively.


Free API Calls Limit

QuestionPro provides free API calls with the subscription. Following table displays the free API calls limit for each license:

Licence No. of API calls
Advanced 5,000
Team Edition 10,000
Research Edition 20,000
Communities 20,000
Customer Experience 20,000
Workforce 20,000
University Site License 10,000
University Research Edition 20,000

With all the trial licenses, you will get 500 free API calls.


It's important to be aware that once you have reached the free API limits provided with your subscription, the APIs will no longer be accessible. Any API calls made after the limit is exhausted will result in a 429 Too Many Requests HTTP status. To continue using the APIs, please get in touch with your account representative to explore purchasing additional API calls for your subscription.

application/json 

    {
    "response": {
        "error": {
             "docs": "https://www.questionpro.com/api/v2/#error-codes",
             "message": "API call limit exceeded. Please contact your account representative to extend the limits.",
             "id": 1013,
             "name": "",
             "httpStatusCode": 429,
             "resourceUrl":
"http://api.questionpro.{{env}}/a/api/v2/users/{{user-id}}/surveys?page=1&perPage=100"
        }
    }
}

Resource Limit

By default, the limit of 100 items/resource per API call is considered for each API call supporting pagination. But the maximum limit of 1000 items/resource per API call is supported by QuestionPro.


Size Of Individual Request

Our servers have a request limit of 8000 bytes (characters) for the request URL. It is recommended to impose a limit of 8000 characters on your API request URL to ensure that the request is not rejected by our server.