Developers

Eldon Fax API

Send, list, retrieve, and forward faxes and manage contacts programmatically. A REST API for integrating Eldon into your own apps and workflows.

Base URL

https://api.eldonfax.com

All requests use HTTPS and return JSON. The API is available on the Scale plan and custom plans.

Authentication

Authenticate every request with an organization API key, sent as a bearer token. Create and manage keys from your dashboard under Settings → API keys. Keys are scoped to your organization and shown in full only once at creation — store them securely.

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx

Each key carries scopes that gate what it can do: faxes:read, faxes:write, contacts:read, contacts:write.

Rate Limits

LimitScope
100 requests / minuteper API key
10 fax sends / minuteper workspace (organization)

Responses include X-RateLimit-Limit and X-RateLimit-Remaining. When exceeded you receive 429 Too Many Requests with a Retry-After header (seconds).

Errors

Errors return a consistent JSON envelope with an HTTP status code.

{
  "success": false,
  "message": "Invalid API key",
  "code": "INVALID_API_KEY"
}
StatusMeaning
400Invalid request (missing/invalid fields)
401Missing or invalid API key
403Key lacks the required scope, or plan not eligible
404Resource not found
429Rate limit exceeded