> ## Documentation Index
> Fetch the complete documentation index at: https://docs.farelint.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Credits & pricing

> Monthly plans, airline search rates and credit accounting.

Farelint offers three monthly plans. There is no public Free tier and no automatic overage.

## Monthly plans

Prices are in USD per month, before applicable tax.

| Plan | USD / month | Credits / month |
| - | -: | -: |
| Starter | \$29 | 10,000 |
| Growth | \$99 | 50,000 |
| Scale | \$249 | 150,000 |

Running collection limits are **5** for Starter, **15** for Growth and **30** for Scale. See [concurrent requests](#concurrent-requests) for queueing and source capacity.

Pilot accounts are invitation-only. [Request access](https://farelint.com/pilot), then sign in and open **Billing** to choose a monthly subscription. An account or API key alone does not activate paid collection. Credits are granted after a qualifying paid subscription invoice is reconciled. Existing operator-managed developer test access is preserved; it is not a public Free plan.

## Credits per airline

Search prices vary by airline. `GET /v1/airlines` discloses `async_credits`, `sync_credits`, `cost_version` and `pricing_basis`. Explicit `/v1/searches/async` and the original `/v1/searches` charge the source weight only. `/v1/searches/sync` adds **2 credits** to that weight.

Current search rates:

| Airline | Async credits / search | Sync credits / search |
| - | -: | -: |
| Ryanair | 2 | 4 |
| easyJet | 7 | 9 |
| AEGEAN | 5 | 7 |
| Emirates | 10 | 12 |
| Qatar Airways | 9 | 11 |
| LATAM Airlines | 11 | 13 |
| Avianca | 3 | 5 |
| Copa Airlines | 3 | 5 |
| Ethiopian Airlines | 4 | 6 |
| Kenya Airways | 4 | 6 |

The [website pricing table](https://farelint.com/#airline-credits) also shows current rates. The source rate covers one search context: one airline, airport pair, exact departure and optional return dates, passenger mix, cabin and market. It can return several options; there is no per-flight charge within that result. Separate date combinations or airline searches are separate requests. Details operations use their own disclosed rate when enabled.

Check enabled operations and supported request context before submitting work. A listed price does not establish route availability. See [airline coverage](https://docs.farelint.com/airlines.md).

## Async, sync and MCP

| Request or action | Credit cost |
| - | - |
| `POST /v1/searches` or `POST /v1/searches/async` | Airline async rate |
| `POST /v1/searches/sync` | Airline async rate + 2 credits |
| MCP `farelint_search_flights` | Airline async rate |
| Job polling, usage reads and request history | No additional credits |
| Completion webhooks and delivery retries | No additional credits |

For example, a completed Ryanair async search uses **2 credits**, or **4 credits** through sync. A completed Emirates async search uses **10 credits**, or **12 credits** through sync. See the [MCP guide](https://docs.farelint.com/integrations.md) for agent setup.

Admission freezes `credit_quote.source_credits`, `sync_surcharge`, `total_credits`, delivery mode, basis and `cost_version`. `max_credits` caps the total, including the sync surcharge. A later price change never reprices an existing job.

## Reservations and charges

Submitting a job reserves its full quoted cost before it enters the queue. Reservation reduces available credits while the job is queued or running; it is settled only when the job reaches a terminal state.

Complete results charge once; partials and failures release the **whole** reservation, including the sync fee. Confirmed complete `no_flights` is charged. Retries add no customer charge. Replaying an idempotency key and polling are free. A synchronous client disconnect does not cancel its accepted job or create another charge; retrieve the same job or reuse the same key. Use async when a client or proxy cannot keep a connection open.

Use a new idempotency key for a different payload or delivery mode. Reusing a key with different input returns `409 idempotency_conflict`.

## Balance and monthly periods

Paid subscription credits follow the paid Stripe subscription period. A qualifying paid cycle invoice creates one grant for that period; duplicate webhook deliveries or checkout-return reconciliation do not refill it. Unused credits do not roll over. Existing operator-managed test accounts retain their UTC calendar-month grants. Reservations always settle against their original grant.

`GET /v1/usage` returns `period`, `granted`, `consumed`, `reserved`, `available`, `overages: false`, ledger and `next_cursor`. Pages hold up to 50 newest-first entries. Pass `?cursor=NEXT_CURSOR` for the next workspace-scoped page. Insufficient credits return `402`. Uncharged failed attempts still count toward the 30-attempt/hour budget. Month-boundary reservations settle against their original grant.

## Concurrent requests

| Plan | Running collection limit per workspace |
| - | -: |
| Starter | 5 |
| Growth | 15 |
| Scale | 30 |

Existing developer preview accounts have one running slot. Accounts without an active plan cannot submit requests (`402 subscription_required`). API keys cannot select or upgrade a plan.

The limit applies to running jobs across every API key, sync and async search endpoints, MCP tools and details operations. Requests beyond this execution limit remain queued, subject to the existing queue limit of ten waiting jobs, job deadlines, service capacity and per-airline concurrency limits. Submitting a job reserves its quoted credits; waiting does not charge extra credits. Polling and webhook delivery occupy no collection slot. The synchronous endpoint's two-credit surcharge does not bypass the queue.

`GET /v1/usage` additionally returns `plan: {id, name}` and `concurrency: {limit, running, queued}`. Counts are workspace-scoped snapshots. A downgrade leaves already-running work intact and pauses new claims until usage falls below the lower limit.

The pilot retains a separate 30-attempt/hour safety budget and one slot per airline. Actual simultaneous execution remains subject to service capacity and source availability.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.