Billing & Pricing
API pricing tiers, rate limits, quotas, and subscription management
Billing & Pricing
The Andamio API uses tiered pricing. Each tier determines your rate limits, monthly quota, and maximum number of API keys.
Pricing Tiers
| Tier | Price | Monthly Requests | Daily Limit | Per-Minute | Per-Second | Max Keys |
|---|---|---|---|---|---|---|
| Pioneer | Free | 15,000 | 500 | 20 | 20 | 1 |
| Starter | $29/mo | 75,000 | 2,500 | 50 | 50 | 2 |
| Growth | $129/mo | 750,000 | 25,000 | 500 | 500 | 5 |
| Enterprise | Custom | 999,999+ | 100,000 | 2,000 | 2,000 | Unlimited |
Start with Pioneer (free) for development and testing. Upgrade when you need higher limits.
Rate Limit Headers
Every API response includes rate limit information:
| Header | Description |
|---|---|
X-RateLimit-Limit | Maximum requests allowed in the current window |
X-RateLimit-Remaining | Requests remaining in the current window |
X-RateLimit-Reset | Unix timestamp when the window resets |
When you exceed your rate limit, the API returns 429 Too Many Requests. Implement backoff based on the X-RateLimit-Reset header.
View Available Plans
List current pricing tiers (no authentication required):
curl https://preprod.api.andamio.io/api/v2/billing/plansSubscription 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
| Status | Meaning |
|---|---|
active | Subscription is current and paid |
active + cancel_at_period_end | Active but will cancel at period end |
past_due | Payment failed — retrying |
canceled | Subscription ended |
trialing | In trial period |
incomplete | Initial payment pending |
paused | Subscription paused |
Billing Endpoints
| Method | Endpoint | Auth Required | Description |
|---|---|---|---|
GET | /v2/billing/plans | None | List available tiers (public) |
POST | /v2/billing/checkout | API Key + Developer JWT | Create Stripe checkout session |
POST | /v2/billing/portal | API Key + Developer JWT | Create Stripe customer portal |
GET | /v2/billing/status | API Key + Developer JWT | Check subscription status |
Next Steps
- API Keys — Create and manage API keys for your tier
- API Integration — Making requests with rate limit awareness
- Developer Accounts — Registration and account setup