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
| 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