Skip to main content
POST
/
v1
/
teams
/
{team_id}
/
subscription
/
verify
Verify Subscription
curl --request POST \
  --url https://api.dataraven.io/v1/teams/{team_id}/subscription/verify \
  --header 'Authorization: Bearer <token>'
{
  "has_subscription": true,
  "subscription_tier": "<string>",
  "is_active": true,
  "id": "<string>",
  "team_id": "<string>",
  "status": "<string>",
  "current_period_start": "<string>",
  "current_period_end": "<string>",
  "cancel_at_period_end": false,
  "canceled_at": "<string>",
  "amount": 123,
  "currency": "<string>",
  "polar_sub_id": "<string>",
  "polar_cust_id": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
team_id
string<uuid>
required

Response

Successful Response

Unified subscription response for both FREE and PRO tiers.

This schema handles both FREE tier teams (no subscription record) and PRO tier teams (with full subscription details).

For FREE tier:

  • has_subscription: False
  • subscription_tier: "free"
  • All subscription-specific fields will be None

For PRO tier:

  • has_subscription: True
  • subscription_tier: "pro"
  • All subscription fields populated
​
has_subscription
boolean
required

True if team has a subscription record

​
subscription_tier
string
required

Subscription tier (free or pro)

​
is_active
boolean
required

True if PRO tier is currently active

​
id
string | null

Subscription UUID

​
team_id
string | null

Team UUID

​
status
string | null

Polar subscription status (active, canceled, unpaid, etc.)

​
current_period_start
string | null

Billing period start (ISO format)

​
current_period_end
string | null

Billing period end (ISO format)

​
cancel_at_period_end
boolean
default:false

If true, subscription will end at current_period_end

​
canceled_at
string | null

Cancellation timestamp (ISO format)

​
amount
number | null

Subscription amount in dollars (e.g., 20.00)

​
currency
string | null

Currency code (usd)

​
polar_sub_id
string | null

Polar subscription ID

​
polar_cust_id
string | null

Polar customer ID