Rate limits

The Visamundi API is intended for server-to-server integrations. Each API key has a monthly request quota, reset on the 1st of every month.

Key	Monthly quota
Trial key	100 requests
Partner key	Set in your partner agreement

/hello does not count towards the quota, and neither do requests refused with 403 plan_restricted.

Response headers

Every counted response tells you where you stand:

Header	Meaning
RateLimit-Limit	Your monthly quota.
RateLimit-Remaining	Requests left this month.
RateLimit-Reset	Seconds until the quota resets (start of next month).

When the quota runs out

Further requests return 429 until the reset:

{
  "success": false,
  "statusCode": 429,
  "code": "quota_exceeded",
  "message": "Quota exceeded for this API key"
}

Best practices

• Cache aggressively. Reference data (countries, currencies, vaccines) changes infrequently. Cache it on your side and refresh periodically rather than per user request.
• Call from your backend. Don’t fan out requests from end-user browsers; proxy and batch through your own service.
• Back off on errors. If you receive 5xx responses, retry with exponential backoff rather than tight loops.

If your use case needs more volume, request access and we’ll discuss limits for your account.