Skip to main content
The Billing API gives you programmatic access to your Miteos subscription details, real-time usage metrics, invoice history, and plan upgrade flows. Use these endpoints to build internal dashboards, trigger alerts when usage approaches limits, or automate seat management.
Upgrade vs. downgrade timing differs.
  • Upgrades take effect immediately. Your account gains access to higher limits and features the moment the Stripe checkout session completes.
  • Downgrades take effect at the end of your current billing period. You retain current-plan access until then, and the lower-tier limits apply from the next renewal date.

​
Authentication

All requests require a Bearer token in the Authorization header. 
Authorization: Bearer mt_live_xxx

​
Plan Limits Reference

The table below summarises the limits across all available plans.
FeatureFreePro ($49/mo)Power ($149/mo)Business (custom)
Tasks per month5050050,000Unlimited
Agent minutes per month602,00010,000Unlimited
Credits included1002,50010,000Custom
Concurrent agents1520Custom
Virtual card issuance✗✗✗✓
Live trading✗✓✓✓
SLA & dedicated support✗✗✓✓

​
GET /billing

Retrieve your current subscription plan and a summary of usage for the active billing period.

​
Response Fields

​
plan
string
The current plan name. One of free, pro, power, business.
​
billing_period_start
string
ISO 8601 date for the start of the current billing cycle.
​
billing_period_end
string
ISO 8601 date for the end of the current billing cycle.
​
tasks_used
number
Number of tasks consumed in the current billing period.
​
tasks_limit
number
Maximum tasks allowed under your current plan per billing period.
​
agents_minutes
number
Total agent execution minutes used in the current billing period.
​
credits_remaining
number
Credits remaining in your account. Credits are consumed by premium AI model calls and certain integrations.

​
Examples

curl --request GET \
  --url https://api.miteos.com/v1/billing \
  --header 'Authorization: Bearer mt_live_xxx'
Example Response
{
  "plan": "pro",
  "billing_period_start": "2024-11-01",
  "billing_period_end": "2024-11-30",
  "tasks_used": 4213,
  "tasks_limit": 10000,
  "agents_minutes": 874,
  "credits_remaining": 1340
}

​
GET /billing/invoices

Return a paginated list of all invoices for your account, ordered by date descending.

​
Response Fields

​
id
string
Unique invoice identifier.
​
amount
number
Invoice total in USD.
​
status
string
Payment state. One of paid, open, void.
​
period_start
string
The billing period start date this invoice covers.
​
period_end
string
The billing period end date this invoice covers.
​
pdf_url
string
A time-limited URL to download the invoice as a PDF.

​
Examples

curl --request GET \
  --url https://api.miteos.com/v1/billing/invoices \
  --header 'Authorization: Bearer mt_live_xxx'
Example Response
{
  "data": [
    {
      "id": "inv_2024_11",
      "amount": 49.00,
      "status": "paid",
      "period_start": "2024-11-01",
      "period_end": "2024-11-30",
      "pdf_url": "https://billing.miteos.com/invoices/inv_2024_11.pdf?token=eyJ...",
      "created_at": "2024-11-01T00:00:00Z"
    },
    {
      "id": "inv_2024_10",
      "amount": 49.00,
      "status": "paid",
      "period_start": "2024-10-01",
      "period_end": "2024-10-31",
      "pdf_url": "https://billing.miteos.com/invoices/inv_2024_10.pdf?token=eyJ...",
      "created_at": "2024-10-01T00:00:00Z"
    }
  ],
  "has_more": false
}

​
POST /billing/checkout

Start a Stripe checkout session to upgrade or change your plan. The response includes a checkout_url you should redirect the user to. Stripe handles payment collection and returns the user to your configured redirect URL on completion.

​
Request

​
plan
string
required
The target plan. Accepted values: free, pro, power, business.
​
billing_period
string
required
Payment cadence. Accepted values: monthly, annual. Annual billing provides a discount — refer to the pricing page for current rates.

​
Response Fields

​
checkout_url
string
The Stripe-hosted checkout URL to redirect the user to. This URL expires after 30 minutes.
​
session_id
string
The Stripe Checkout session ID, useful for reconciliation or webhook verification.

​
Examples

curl --request POST \
  --url https://api.miteos.com/v1/billing/checkout \
  --header 'Authorization: Bearer mt_live_xxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "plan": "power",
    "billing_period": "annual"
  }'
Example Response
{
  "checkout_url": "https://checkout.stripe.com/c/pay/cs_live_a1b2c3d4...",
  "session_id": "cs_live_a1b2c3d4e5f6g7h8i9j0",
  "expires_at": "2024-11-14T14:30:00Z"
}
For the business plan, the checkout flow routes you to a contact form rather than a direct Stripe payment page. A member of the Miteos sales team will reach out within one business day to discuss pricing and custom limits.

​
GET /billing/usage

Return a detailed breakdown of usage for the current billing period, segmented by category and agent.

​
Response Fields

​
tasks_used
number
Total tasks executed in the current period.
​
tasks_limit
number
Task cap for your current plan.
​
agents_minutes
number
Total agent runtime in minutes.
​
credits_remaining
number
Credits available for premium operations.
​
breakdown
array
Per-agent usage records. Each entry includes agent_id, agent_name, tasks, and minutes.

​
Examples

curl --request GET \
  --url https://api.miteos.com/v1/billing/usage \
  --header 'Authorization: Bearer mt_live_xxx'
Example Response
{
  "tasks_used": 4213,
  "tasks_limit": 10000,
  "agents_minutes": 874,
  "credits_remaining": 1340,
  "breakdown": [
    {
      "agent_id": "agt_1a2b3c",
      "agent_name": "Marketing Content Agent",
      "tasks": 2105,
      "minutes": 412
    },
    {
      "agent_id": "agt_4d5e6f",
      "agent_name": "Trading Strategy Agent",
      "tasks": 1840,
      "minutes": 360
    },
    {
      "agent_id": "agt_7g8h9i",
      "agent_name": "Commerce Approvals Agent",
      "tasks": 268,
      "minutes": 102
    }
  ]
}
When tasks_used reaches tasks_limit, all agent task execution is paused until the next billing period begins or you upgrade your plan. To avoid disruption, set up usage alerts in Settings → Billing → Usage Alerts.