---
title: "Subscriptions"
description: "Subscription plans and tier management — Free, Basic, Pro, and Enterprise"
canonical: "https://docs.ainative.studio/docs/billing/subscriptions"
last-updated: "2026-10-22T17:48:46.689Z"
---

# Subscriptions

Source: https://docs.ainative.studio/docs/billing/subscriptions

> Subscription plans and tier management — Free, Basic, Pro, and Enterprise

# Subscriptions

Manage your AINative subscription plan — view current plan details, compare available plans, upgrade or downgrade, and inspect usage against your plan limits.

**Base URL:** `https://api.ainative.studio`

---

## Available Plans

<span className="badge badge--get">GET</span> `/api/v1/subscription/plans`

List all available subscription plans. No authentication required.

```bash
curl https://api.ainative.studio/api/v1/subscription/plans
```

```python
import httpx

resp = httpx.get("https://api.ainative.studio/api/v1/subscription/plans")
plans = resp.json()["data"]["plans"]
```

**Response**

```json
{
  "success": true,
  "data": {
    "plans": [
      {
        "id": "starter",
        "name": "Starter",
        "credits": 1000,
        "price": 0,
        "currency": "USD",
        "interval": "month",
        "features": [
          "1,000 API credits",
          "10K LLM tokens",
          "0.5 GB storage",
          "Community support"
        ]
      },
      {
        "id": "pro",
        "name": "Pro",
        "credits": 50000,
        "price": 49.00,
        "currency": "USD",
        "interval": "month",
        "features": [
          "50,000 API credits",
          "1M LLM tokens",
          "10 GB storage",
          "50 MCP hours",
          "Email support"
        ]
      },
      {
        "id": "business",
        "name": "Business",
        "credits": 150000,
        "price": 149.00,
        "currency": "USD",
        "interval": "month",
        "features": [
          "150,000 API credits",
          "5M LLM tokens",
          "50 GB storage",
          "500 MCP hours",
          "Cody included",
          "Priority support"
        ]
      },
      {
        "id": "enterprise",
        "name": "Enterprise",
        "credits": 200000,
        "price": 699.00,
        "currency": "USD",
        "interval": "month",
        "features": [
          "200,000 API credits",
          "10M LLM tokens",
          "100 GB storage",
          "1,000 MCP hours",
          "Cody + Swarm",
          "Dedicated support"
        ]
      }
    ]
  }
}
```

---

## Get Current Subscription

<span className="badge badge--get">GET</span> `/api/v1/subscription`

Returns full subscription details for the authenticated user. Returns `null` under `subscription` if no active subscription exists.

**Auth required.**

```bash
curl https://api.ainative.studio/api/v1/subscription \
  -H "Authorization: Bearer <your_api_key>"
```

```python
import httpx

resp = httpx.get(
    "https://api.ainative.studio/api/v1/subscription",
    headers={"Authorization": "Bearer <your_api_key>"},
)
sub = resp.json()["data"]["subscription"]
if sub:
    print(sub["plan"]["name"], sub["status"])
```

**Response** (active subscription)

```json
{
  "success": true,
  "data": {
    "subscription": {
      "id": "sub-uuid",
      "status": "active",
      "current_period_start": "2026-04-01T00:00:00Z",
      "current_period_end": "2026-04-30T23:59:59Z",
      "cancel_at_period_end": false,
      "canceled_at": null,
      "plan": {
        "id": "pro",
        "name": "Pro",
        "price": 49.00,
        "currency": "USD",
        "interval": "month",
        "features": ["50,000 API credits", "1M LLM tokens", "10 GB storage", "50 MCP hours", "Email support"],
        "is_active": true
      },
      "auto_renew": true,
      "quantity": 1
    }
  }
}
```

---

## Get Public Subscription Details

<span className="badge badge--get">GET</span> `/api/v1/subscription/public`

A simplified subscription view that includes credit balances and plan limits. Suitable for displaying on user dashboards without admin privileges.

**Auth required.**

```bash
curl https://api.ainative.studio/api/v1/subscription/public \
  -H "Authorization: Bearer <your_api_key>"
```

**Response** (with active plan)

```json
{
  "success": true,
  "data": {
    "plan_name": "Professional",
    "tier": "pro",
    "status": "active",
    "renewal_date": "2026-04-30T23:59:59Z",
    "current_period_start": "2026-04-01T00:00:00Z",
    "current_period_end": "2026-04-30T23:59:59Z",
    "billing_cycle": "month",
    "credits_remaining": 37659,
    "credits_total": 50000,
    "features": [
      "50,000 API credits",
      "1M LLM tokens",
      "10 GB storage",
      "50 MCP hours",
      "Email support"
    ],
    "limits": {
      "api_credits": 50000,
      "llm_tokens": 1000000,
      "max_users": 5,
      "max_projects": 10
    }
  }
}
```

**Response** (no active subscription — free tier)

```json
{
  "success": true,
  "data": {
    "plan_name": "Free",
    "tier": "free",
    "status": "active",
    "renewal_date": null,
    "credits_remaining": 500,
    "credits_total": 500,
    "features": ["500 AI credits per month", "Basic support", "Community access"],
    "limits": {
      "api_credits": 500,
      "llm_tokens": 50000,
      "max_users": 1,
      "max_projects": 1
    }
  }
}
```

---

## Upgrade or Downgrade Plan

<span className="badge badge--put">PUT</span> `/api/v1/subscription`

Change the authenticated user's plan. If an active subscription exists it is updated in place; otherwise a new subscription is created with an initial invoice.

**Auth required.**

**Request body**

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `plan` | string | Yes | Plan ID from `GET /subscription/plans` (e.g. `"pro"`, `"business"`) |

```bash
curl -X PUT https://api.ainative.studio/api/v1/subscription \
  -H "Authorization: Bearer <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{"plan": "pro"}'
```

```python
import httpx

resp = httpx.put(
    "https://api.ainative.studio/api/v1/subscription",
    headers={"Authorization": "Bearer <your_api_key>"},
    json={"plan": "pro"},
)
print(resp.json()["message"])
```

**Response**

```json
{
  "success": true,
  "data": {
    "id": "sub-uuid",
    "plan": "pro",
    "status": "active",
    "current_period_start": "2026-04-25T10:00:00Z",
    "current_period_end": "2026-05-25T10:00:00Z",
    "plan_details": {
      "id": "pro",
      "name": "Pro",
      "credits": 50000,
      "price": 49.00,
      "currency": "USD",
      "interval": "month",
      "features": [...]
    }
  },
  "message": "Subscription updated to Pro plan"
}
```

**Error responses**

| Status | Cause |
|--------|-------|
| `400` | Invalid plan ID |
| `401` | Not authenticated |
| `500` | Database or Stripe error |

---

## Usage Analytics

<span className="badge badge--get">GET</span> `/api/v1/subscription/usage`

All-time and current-month usage statistics against your plan limits.

**Auth required.**

```bash
curl https://api.ainative.studio/api/v1/subscription/usage \
  -H "Authorization: Bearer <your_api_key>"
```

**Response**

```json
{
  "success": true,
  "data": {
    "total_credits_used": 145230.5,
    "total_requests": 8420,
    "active_days": 87,
    "last_activity": "2026-04-25T09:55:00Z",
    "monthly_credits_used": 12340.5,
    "monthly_requests": 1204,
    "daily_usage": [
      {
        "date": "2026-04-25",
        "credits": 540.0,
        "requests": 54
      }
    ]
  }
}
```