Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.methodfi.com/llms.txt

Use this file to discover all available pages before exploring further.

Method enforces rate limits on all API requests to protect platform stability and ensure fair usage across all customers. Rate limits apply to all environments (Development, Sandbox, and Production) and all API versions.

How rate limits work

Requests are counted per API key within a 60-second rolling window. Limits are applied across multiple tiers based on operation type — more sensitive operations (such as payment creation) have stricter limits, while high-volume read and write operations have more generous allowances. Each tier tracks its own counter independently, so usage against one tier does not affect your capacity in another. When a rate limit is exceeded, requests matching that tier are blocked for 60 seconds, after which requests are automatically accepted again.
The same rate limits apply across all environments (Development, Sandbox, and Production). Rate limits encountered during testing in Development or Sandbox reflect the same thresholds your integration will experience in Production.

Rate limit response

When rate limited, the API returns an HTTP 429 status code with the following response body:
{
  "success": false,
  "data": {
    "error": {
      "type": "INVALID_REQUEST",
      "code": 429,
      "sub_type": "TOO_MANY_REQUESTS",
      "message": "The maximum request limit for this time has been exceeded. Please re-try your request at a later time."
    }
  },
  "message": "The maximum request limit for this time has been exceeded. Please re-try your request at a later time."
}

Handling rate limits

When you receive a 429 response, the block lasts for 60 seconds. Retrying immediately will not succeed. We recommend waiting at least 60 seconds before retrying, then using exponential backoff if subsequent attempts are still rate limited. Combine rate limit retries with idempotency keys on POST requests to ensure retried requests are not processed more than once.

Enterprise rate limits

Customers with high-volume integrations can request custom rate limits tailored to their usage patterns. Contact your account manager or reach out to our team to discuss enterprise rate limit overrides.