GET
/
subscription
/
status
GET /subscription/status
curl --request GET \
  --url https://api.example.com/subscription/status \
  --header 'Authorization: <authorization>'
{
  "404": {},
  "wallet_address": "<string>",
  "tier": "<string>",
  "is_active": true,
  "expires_at": "<string>",
  "instances_used": 123,
  "instances_limit": 123,
  "requests_today": 123,
  "requests_limit": 123
}

​
Overview

Retrieve your current subscription tier, expiration date, and usage statistics.

​
Request

curl https://api.agentik.dev/api/subscription/status \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

​
Headers

​
Authorization
string
required
Bearer token from /auth/login

​
Response

{
  "wallet_address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "tier": "pro",
  "is_active": true,
  "expires_at": "2026-03-15T10:30:00Z",
  "instances_used": 2,
  "instances_limit": 5,
  "requests_today": 1457,
  "requests_limit": 10000,
  "storage_used_mb": 256,
  "storage_limit_mb": 1024
}
​
wallet_address
string
Your Solana wallet address
​
tier
string
Subscription tier: free, pro, or enterprise
​
is_active
boolean
Whether subscription is currently active
​
expires_at
string
ISO 8601 timestamp when subscription expires
​
instances_used
number
Number of active instances
​
instances_limit
number
Maximum instances allowed for tier
​
requests_today
number
API requests made today
​
requests_limit
number
Daily request limit for tier

​
Subscription Tiers

  • free: 1 instance, 1,000 requests/day, 100 MB storage
  • pro: 5 instances, 10,000 requests/day, 1 GB storage
  • enterprise: Unlimited instances/requests, 10 GB storage

​
Errors

​
404
error
No subscription found - user needs to subscribe