Errors and rate limits

​

Errors

EDN uses standard HTTP status codes. A successful call returns a 2xx status. On failure, expect the usual classes:

• Authentication failures when the Authorization: Bearer header is missing or invalid. See Authentication.
• Validation errors when a request body or parameter is malformed.
• Rate limit errors when a limit is exceeded (see below).

For the exact response shape of any endpoint, use the API Reference, which is generated from the OpenAPI specification.

​

Rate limits

Rate limiting is an abuse guard. It exists to stop a runaway script or a compromised key from saturating the backend. It is not a performance lever: tiers do not change how fast EDN responds. Two kinds of limit apply:

• A per-minute request rate, measured over a 60-second window.
• Daily caps on ingest and SIP builds, which reset at midnight UTC.

When a limit is exceeded, EDN rejects the request with a rate limit response and a retry indication.

​

Limits by tier