Home · Docs · How we calculate

How we calculate

A figure marked Formula on foxapis.com is our own arithmetic on two files: the credit catalog (what each call costs in credits) and the plans file (what each plan costs and how many credits it holds). This page lists every formula, in plain words, with one worked example worked out from those files as they are today (2026-11-22).

Fact or formula

Every number on a FoxAPIs page is one of three kinds. A fact is copied from a record: a credit count from the catalog, a field of a real response captured on a stated date, a measured response time. A formula is arithmetic on facts, and carries a small Formula link to this page. An estimate is labelled as one and is never mixed into a total. When a page says Every other figure on this page is copied from the record, it means no figure outside the Formula links was calculated by us.

The formulas

Figure on a pageThe formulaWhere it is used
Plan price per creditThe smallest paid plan's monthly price divided by its monthly credits. Today that plan is Builder: $49 ÷ 5,000 credits = $0.0098 a credit.Every price figure
Price of one callThe call's credits (from the credit catalog) times the plan price per credit.API endpoint pages, verify pages
Price of 1,000 callsThe credits per call times 1,000, times the plan price per credit. Equal to the price of one call times 1,000.API endpoint pages, platform pages, use-case pages
Credits per 1,000 callsThe credits per call from the catalog times 1,000.Platform pages
Cost per run and per 1,000 runsThe credits of each call in a run, added up, times the plan price per credit; times 1,000 for 1,000 runs.Developer-job pages, recipes
Dollar figures on a planThe plan's monthly price divided by its monthly credits, times the credits in question. Prices are read from the plans file at build time and are never typed into a page.Developer-job pages, MCP pages
Cost for your callsThe credits per call times the number of calls you type, then the smallest plan whose monthly credits cover that number.Use-case pages, cost estimator, extract pages
Per month (assistant tools)The credits each tool costs times the calls you type, added up across the tools you choose.MCP tool pages
Official cost at your volumeThe published figures on the platform's own pricing or quota page applied to the calls you type: a per-call price times your calls, a plan price for the smallest plan whose call allowance covers them, or no cost while the calls stay inside a free quota. A volume the page lists no price for is shown as having none.Platform pricing pages (pricing explained)
FoxAPIs cost at your volumeThe credits per call times your calls, times the smallest paid plan's price per credit; calls that fit inside the free plan's credits cost nothing. The smallest plan that covers the credits is named beside it.Platform pricing pages (pricing explained)
Price of one checkThe credits per call times the plan price per credit, for a verify page's single check.Verify pages
Cost of the runThe credits per call times the calls a recipe makes, times the plan price per credit.Recipe pages
Per 1,000 (other providers)A provider's plan price divided by the plan's units (credits, searches or responses), times 1,000.Pricing explained, price comparison
Worked examples (other providers)The cheapest option the provider's page lists for 10,000 and 100,000 calls a month; real bills also depend on the site, retries and tax.Pricing explained
Monthly cost, lowest firstFor each provider, the listed price of the cheapest plan or option that covers the number of calls you type (and the share of rendered pages you choose), sorted lowest first; a custom or enterprise quote is not computed.Price comparison

A worked example

Take a call that costs 2 credits, such as /v1/example in the credit catalog, on the smallest paid plan (Builder, $49 for 5,000 credits).

  1. Price per credit: $49 ÷ 5,000 = $0.0098.
  2. One call: 2 credits × $0.0098 = $0.0196.
  3. 1,000 calls: 2,000 credits × $0.0098 = $19.60.
  4. A run that makes three calls costing 1, 1, 2 credits: 4 credits, so $0.0392 a run and $39.20 for 1,000 runs.
  5. Your own volume: if you type 20,000 calls of 2 credits, you need 40,000 credits a month, which is above the listed plans, so it is an enterprise quote.

Rules every formula follows

Where the numbers come from

Credits per call come from the catalog the API itself bills from, checked against the page figures by an audit in every deploy. Plan prices and credits come from plans.json, the one price source the pricing page and checkout also read. Sample responses are real calls captured on the date each page states; response times are measured on those same calls.

Start with 1,000 credits, no card. They arrive once you confirm your email and expire 90 days after they are added; credits you buy never expire.

Start with 1,000 credits

Related: Errors and limits · Pricing · Cost estimator · Docs