Skip to main content
GET
/
v1
/
subscription
Get Subscription
curl --request GET \
  --url https://api.example.com/v1/subscription
{
  "status": "<string>",
  "plan": {
    "name": "<string>",
    "displayName": "<string>",
    "minutesIncluded": 123,
    "features": [
      {}
    ]
  },
  "usage": {
    "minutesUsed": 123,
    "minutesRemaining": 123,
    "minutesIncluded": 123,
    "bonusMinutes": 123,
    "trialMinutes": 123
  },
  "billing": {
    "currentPeriodEnd": "<string>",
    "cancelAtPeriodEnd": true
  },
  "capabilities": {
    "apiAccess": true,
    "wordExport": true,
    "incomingNumber": true,
    "callerIdMasking": true,
    "contactSync": true,
    "webhooks": true
  }
}
Returns comprehensive information about your subscription status, plan details, usage, and capabilities.

Request

curl -X GET "https://app.transcord.app/api/v1/subscription" \
  -H "Authorization: Bearer tr_live_your_api_key"

Response

status
string
Subscription status: active, trialing, past_due, canceled, or none
plan
object
Current plan details (null if no subscription)
usage
object
billing
object
Billing information (null if not subscribed)
capabilities
object
Feature flags for your plan
Response
{
  "status": "active",
  "plan": {
    "name": "pro",
    "displayName": "Pro",
    "minutesIncluded": 500,
    "features": ["api_access", "word_export", "incoming_number", "contact_sync"]
  },
  "usage": {
    "minutesUsed": 127,
    "minutesRemaining": 373,
    "minutesIncluded": 500,
    "bonusMinutes": 0,
    "trialMinutes": 0
  },
  "billing": {
    "currentPeriodEnd": "2026-02-15T00:00:00.000Z",
    "cancelAtPeriodEnd": false
  },
  "capabilities": {
    "apiAccess": true,
    "wordExport": true,
    "incomingNumber": true,
    "callerIdMasking": true,
    "contactSync": true,
    "webhooks": false
  }
}

Errors

StatusDescription
401Invalid or missing API key
404User not found