Fareflare API reference
Create a revocable API key in the dashboard and send it as Authorization: Bearer YOUR_KEY. Creating monitors and webhooks also requires a unique Idempotency-Key header (8–128 characters); reuse it when retrying the same request.
Prices use integer minor units: USD 123.45 is 12345. Lists are paginated using limit and cursor. Honor Retry-After on HTTP 429.
Download the OpenAPI schema for request fields and response types. Connect an MCP client to https://fareflare.dev/mcp using OAuth or a bearer API key.
| Method | Path | Purpose |
|---|---|---|
GET | /health | Health |
POST | /v1/monitors | Create |
GET | /v1/monitors | List Monitors |
POST | /v1/webhooks | Register Webhook |
GET | /v1/webhooks | List Webhooks |
GET | /v1/webhooks/{webhook_id} | Get Webhook |
DELETE | /v1/webhooks/{webhook_id} | Delete Webhook |
POST | /v1/webhooks/{webhook_id}/challenge | Challenge Webhook |
POST | /v1/webhooks/{webhook_id}/verify | Verify Webhook |
POST | /v1/webhooks/{webhook_id}/disable | Disable Webhook |
GET | /v1/monitors/{monitor_id} | Get Monitor |
PATCH | /v1/monitors/{monitor_id} | Update Monitor |
GET | /v1/monitors/{monitor_id}/history | History |
GET | /v1/alerts | Alerts |
POST | /v1/alerts/{delivery_id}/retry | Retry |
POST | /v1/monitors/{monitor_id}/retry-collection | Retry Collection |
PUT | /v1/monitors/{monitor_id}/policy | Policy |
GET | /v1/preferences | Preferences |
PUT | /v1/preferences | Update Preferences |
POST | /v1/preferences/telegram-preview | Telegram Preview |
GET | /v1/config | Public Config |
POST | /auth/register | Register |
POST | /auth/login | Login |
POST | /auth/recover | Recover |
POST | /auth/logout | Logout |
GET | /v1/account | Account |
DELETE | /v1/account | Delete Account |
GET | /v1/api-keys | List Keys |
POST | /v1/api-keys | Create Key |
DELETE | /v1/api-keys/{identifier} | Revoke Key |
GET | /v1/telegram | Telegram Status |
POST | /v1/telegram | Telegram Connect |
DELETE | /v1/telegram | Telegram Disconnect |
GET | /v1/oauth/requests/{request_id} | Consent Request |
POST | /v1/oauth/requests/{request_id} | Consent |
GET | /v1/oauth/grants | Connected Apps |
DELETE | /v1/oauth/grants/{identifier} | Disconnect App |