Rate Limits & Error Codes

The Swipe Aras API enforces rate limits to ensure fair access. All API responses include rate limit headers so you can monitor your usage.

Rate Limits

Limit	Value
General rate limit	100 requests per 15 minutes (per IP address)
Burst limit	10 requests per second

Rate Limit Response Headers

Header	Description
`X-RateLimit-Limit`	Maximum requests allowed in the current window
`X-RateLimit-Remaining`	Requests remaining in the current window
`X-RateLimit-Reset`	Unix timestamp when the window resets

When you exceed the rate limit, the API returns HTTP 429 Too Many Requests.

Error Response Format

{
  "success": false,
  "message": "The request body is missing required fields",
  "error": {
    "code": "invalid_request",
    "details": {
      "missing_fields": ["email", "businessName"]
    }
  }
}

HTTP Status Codes

Code	Meaning
`200`	Request succeeded
`201`	Resource created successfully
`400`	Invalid request parameters
`401`	Invalid or missing API key
`403`	Insufficient permissions
`404`	Resource not found
`429`	Rate limit exceeded
`500`	Server error

Optional Request Headers

Header	Description
`X-Request-Id`	Optional unique ID you provide for request tracing. Echoed back in the response.

If you're building a production integration, include X-Request-Id in every request so you can correlate your logs with Swipe Aras support tickets.