GET /api/v1/pricing
Public, unauthenticated endpoint returning the API’s current per-call prices and plan rate/quota limits — check it before you integrate, not after a 402.
What it does
Returns the live per-call price for every billed endpoint plus the rate and quota limits for each plan tier. No x-api-key header, no account, no request body — this is the one endpoint in the API you can call from a browser address bar. Use it to check current pricing before you write any integration code, or to drive an in-app cost estimate without hardcoding numbers that can drift out of sync with what you’re actually billed.
Request
curl https://askbiz.co/api/v1/pricingNo headers, no query parameters, no body.
Response
{
"endpoints": [
{ "path": "/api/v1/scan", "price_cents": 3 },
{ "path": "/api/v1/whatsapp/send", "price_cents": 2 }
],
"plans": {
"free": { "month": 100, "minute": 5 },
"growth": { "month": 10000, "minute": 60 },
"business": { "month": -1, "minute": 120 }
},
"currency": "usd_cents",
"note": "Prices are per successful call — failed or rejected requests are never billed."
}Priced endpoints
Only two endpoints in the API are billed per call. Everything else — /api/v1/ask, /api/v1/connections, and /api/v1/charges — is free within your plan’s quota.
| Endpoint | Price |
|---|---|
/api/v1/scan | 3¢ per successful call |
/api/v1/whatsapp/send | 2¢ per successful call |
As the response’s note field states: prices apply to successful calls only. A rejected or failed request — a 4xx validation error, a 429 rate limit, a 502 upstream failure — is never billed.
Plan limits
month is your monthly request quota across all endpoints combined; -1 means unlimited. minute is your per-minute rate limit, enforced separately from the monthly quota.
| Plan | Monthly quota | Per-minute limit |
|---|---|---|
| free | 100 | 5 |
| growth | 10,000 | 60 |
| business | Unlimited | 120 |
/api/v1/scan and /api/v1/whatsapp/send return your live X-RateLimit-Limit and X-RateLimit-Remaining headers on every response so you don’t have to poll this endpoint to track your own usage — see Rate limits and idempotency.
A note on currency
This endpoint labels prices generically as usd_cents, and that’s accurate for the two per-call prices shown here. It is not the currency used everywhere else in AskBiz: wallet top-up bundles are billed in GBP (£5 / £20 / £100), and the /api/v1/charges endpoint defaults its currency field to gbp when you don’t specify one. Don’t assume one currency across the whole platform — check the currency each individual endpoint actually uses.
Pricing endpoint FAQ
Do I need an API key to call /api/v1/pricing?+
No. This is the one endpoint in the API with no authentication at all — no x-api-key header, no account required.
Am I billed for calling this endpoint?+
No. Pricing lookups are free and not counted against your rate limit or monthly quota — they aren’t billed endpoints at all.
Why does the response say usd_cents but /api/v1/charges defaults to gbp?+
The two per-call endpoint prices (scan, whatsapp/send) are genuinely denominated in USD cents. Charges you create on behalf of a merchant default to GBP instead — the platform doesn’t use one currency everywhere, so check each endpoint’s own currency field rather than assuming.
Does the monthly quota reset, and does it cover all endpoints together?+
The "month" figure in plans is a single combined quota across every endpoint you call with that key, not a per-endpoint allowance. If you exceed it you get a 429 with plan, limit, and used in the error body.