Skip to content
Invogi Docs

Get the organization's current subscription/plan status mirrored from Paddle

GET
/billing/subscription
curl --request GET \
  --url https://api.invogi.com/v1/billing/subscription \
  --header 'Authorization: Bearer <token>'

Authorizations

Section titled “Authorizations”

Responses

Section titled “Responses”

200

Section titled “200”

Subscription

Media typeapplication/json
object
plan_code
required

The final three values are legacy contracts returned for existing subscriptions only

string
Allowed values: CORE CONTROL SCALE ENTERPRISE INVOICE_FIREWALL STARTER GROWTH
status
required
string
Allowed values: trialing active past_due paused canceled
billing_interval
required
string
Allowed values: month year
currency_code
string | null
Allowed values: GBP EUR USD
pricing_version
required
string
invoice_allowance
required

Allowance for the full monthly or annual billing period

integer | null
monthly_invoice_limit
integer | null
additional_legal_entities
required
integer
current_period_end
required
string | null format: date-time

Example 

{
  "plan_code": "CORE",
  "status": "trialing",
  "billing_interval": "month",
  "currency_code": "GBP",
  "pricing_version": "v1-2026-10"
}

401

Section titled “401”

Missing or invalid API key

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: NOT_FOUND UNAUTHORIZED FORBIDDEN INVALID_REQUEST CONFLICT RATE_LIMITED USAGE_LIMIT_EXCEEDED PROCESSING_FAILED
message
required
string
request_id
required
string

Example 

{
  "error": {
    "code": "NOT_FOUND"
  }
}

404

Section titled “404”

Resource not found

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: NOT_FOUND UNAUTHORIZED FORBIDDEN INVALID_REQUEST CONFLICT RATE_LIMITED USAGE_LIMIT_EXCEEDED PROCESSING_FAILED
message
required
string
request_id
required
string

Example 

{
  "error": {
    "code": "NOT_FOUND"
  }
}