Andamio Logo
API

Billing & Pricing

API pricing tiers, rate limits, quotas, and subscription management

The Andamio API uses tiered pricing. Each tier determines your rate limits, monthly quota, and maximum number of API keys.

Pricing Tiers

TierPriceMonthly RequestsDaily LimitPer-MinutePer-SecondMax Keys
Free$015,00050020201
Starter$29/mo75,0002,50050502
Growth$129/mo750,00025,0005005005
EnterpriseCustom999,999+100,0002,0002,000Unlimited

Start with Free for development and testing. Upgrade when you need higher limits.

Quota Headers

This section covers the Andamio API, called with a developer key. Each request that counts against your developer quota returns what is left in its response headers:

HeaderDescription
X-Quota-Remaining-MonthlyRequests left this month, after this one
X-Quota-Reset-MonthlyWhen the monthly quota resets, as an RFC 3339 timestamp (the start of next month, UTC)
X-Quota-Remaining-DailyRequests left today, after this one
X-Quota-Reset-DailyWhen the daily quota resets, as an RFC 3339 timestamp

No header reports the per-second or per-minute limits.

When you exceed a limit, the API returns 429 Too Many Requests. A 429 carries none of these headers, and its body is { "error": "<message>" } rather than the error envelope. The message names the limit you hit: per second, per minute, daily or monthly. After a per-second or per-minute 429, back off and retry within the minute. After a daily or monthly 429, wait until the reset time from your last successful response.

Andamio Issuer keeps its own quota and returns 402 QUOTA_EXHAUSTED when it runs out. See Andamio Issuer API integration.

View Available Plans

List current pricing tiers (no authentication required):

curl https://preprod.api.andamio.io/api/v2/billing/plans

Subscription Management

Manage your subscription through Stripe-hosted pages:

Start or Upgrade Subscription

curl -X POST https://preprod.api.andamio.io/api/v2/billing/checkout \
  -H "X-API-Key: $API_KEY" \
  -H "Authorization: Bearer $DEV_JWT" \
  -H "Content-Type: application/json" \
  -d '{"tier": "starter"}'

Returns a URL to Stripe Checkout. After completing payment, you're redirected back to your app.

Manage Existing Subscription

curl -X POST https://preprod.api.andamio.io/api/v2/billing/portal \
  -H "X-API-Key: $API_KEY" \
  -H "Authorization: Bearer $DEV_JWT"

Returns a URL to the Stripe Customer Portal where you can update payment methods, change plans, or cancel.

Check Subscription Status

curl https://preprod.api.andamio.io/api/v2/billing/status \
  -H "X-API-Key: $API_KEY" \
  -H "Authorization: Bearer $DEV_JWT"

Subscription States

StatusMeaning
activeSubscription is current and paid
active + cancel_at_period_endActive but will cancel at period end
past_duePayment failed — retrying
canceledSubscription ended
trialingIn trial period
incompleteInitial payment pending
pausedSubscription paused

Billing Endpoints

MethodEndpointAuth RequiredDescription
GET/v2/billing/plansNoneList available tiers (public)
POST/v2/billing/checkoutAPI Key + Developer JWTCreate Stripe checkout session
POST/v2/billing/portalAPI Key + Developer JWTCreate Stripe customer portal
GET/v2/billing/statusAPI Key + Developer JWTCheck subscription status

Next Steps