Rate Limits — Proposed Guide

Rate Limits: Rate limiting would protect shared capacity by bounding a client request rate. A proposed 429 response indicates that a request budget was…

Overview

Rate limiting would protect shared capacity by bounding a client request rate. A proposed 429 response indicates that a request budget was exceeded, not that the underlying expense data is invalid.

Key concepts

Treat Retry-After as an instruction if a future contract provides it. Combine bounded exponential backoff with jitter and avoid retrying all queued workers at the same instant.

Implementation considerations

No numerical rate budget is promised. Queue growth, maximum retry time and per-organization fairness should be considered before a future client is deployed.

Proposed API behavior

GET /v1/expenses is an illustrative design for this topic. Path and field names may change before implementation. Access would require an authorized organization context and operation-specific permission; no public API or authorization grant is available here.

Static example requests

# Proposed request text only; this reserved host is not a live API.
curl -X GET 'https://api.remizen.example/v1/expenses?limit=25' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Fictional response example

{
  "data": [
    {
      "retry_after": 10,
      "id": "exp_example_123",
      "organization_id": "org_example_123",
      "merchant": "Example Office Supply",
      "amount_minor": 12550,
      "currency": "USD",
      "status": "draft"
    }
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": null
  },
  "meta": {
    "request_id": "req_example_123",
    "reference_only": true
  }
}

Illustrative error case

Review this failure case in context: No numerical rate budget is promised. Queue growth, maximum retry time and per-organization fairness should be considered before a future client is deployed.

{
  "error": {
    "code": "validation_error",
    "message": "The proposed rate limits operation requires review of its input or authorization.",
    "request_id": "req_example_123"
  }
}

Proposed data types

Related documentation