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

GET

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)

Show properties

name

string

Plan identifier: starter, pro, or business

displayName

string

Human-readable plan name

minutesIncluded

number

Monthly minutes included in plan

features

array

List of feature flags enabled for this plan

usage

object

Show properties

minutesUsed

number

Minutes used this billing period

minutesRemaining

number

Minutes remaining (null for unlimited)

minutesIncluded

number

Total minutes included

bonusMinutes

number

Bonus minutes from referrals or promotions

trialMinutes

number

Trial minutes if applicable

billing

object

Billing information (null if not subscribed)

Show properties

currentPeriodEnd

string

ISO 8601 date when current period ends

cancelAtPeriodEnd

boolean

Whether subscription will cancel at period end

capabilities

object

Feature flags for your plan

Show properties

apiAccess

boolean

Can use the API

wordExport

boolean

Can export transcripts as Word documents

incomingNumber

boolean

Can have a dedicated incoming number

callerIdMasking

boolean

Can use incoming number as caller ID

contactSync

boolean

Can sync Google Contacts

webhooks

boolean

Can configure webhooks

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

Status	Description
`401`	Invalid or missing API key
`404`	User not found

Update User List Plans

​Request

​Response

​Errors

Request

Response

Errors