Token & Rate Limits
Token Limits
vSure leverages Auth0 M2M tokens.
Tokens survive 24 hours. We ask that you reuse tokens and do not create new tokens for each check.
A Token limit of 48 per 24 hours applies to each client ID.
Rate Limits
vSure works with an array of different organisations with an array of different use cases for visa checks and volumes.
We offer 2 levels of rate limits within 2 windows:
Standard: 60 requests per min - up to 10,000/day
Premium: 144 requests per min - up to 24,000/day
Please note: these are NOT visa check limits, but total of all requests (sending a visa check + querying the result + obtaining the pdf = 3 separate requests)
Response Header Fields to track rate limits
The following headers are added to every API response:
'min-quota-consumed' - Consumed requests count in the current minute
'min-quota-remaining' - Remaining quota (requests count) for the current minute
'day-quota-consumed' - consumed requests count on the day
'day-quota-remaining' - remaining quota (requests count) for the day
Rate Limit Exceeded - Error
When a single client ID consumes all allocated quota limit (any one of the limit, ie minute or day), subsequent API calls will result in an HTTP 429 error (429 Too Many Requests). You will need to wait until the quota limits are reset and retry again. The quota limits will get reset automatically on the completion of the specific limit duration (ie minute, day etc whatever is applicable).