curl --request GET \
--url https://api.pomerado.ai/v1/billing \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.pomerado.ai/v1/billing', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.pomerado.ai/v1/billing"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"plan": "free",
"status": "free",
"interval": "monthly",
"current_period_end": "<string>",
"live": true,
"portal": true,
"checkout": {
"monthly": true,
"yearly": true
},
"yearly_switch": {
"available": true,
"scheduled": {
"schedule_id": "<string>",
"starts_at": "<string>"
},
"needs_support": true
},
"promotion": {
"offer_name": "<string>",
"ends_at": "<string>",
"billing_resumes_at": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}Get your subscription
Returns your Personal account’s plan and Premium subscription, any free Premium period from a redeemed code (promotion), and what checkout and the billing portal offer.
curl --request GET \
--url https://api.pomerado.ai/v1/billing \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.pomerado.ai/v1/billing', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.pomerado.ai/v1/billing"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"plan": "free",
"status": "free",
"interval": "monthly",
"current_period_end": "<string>",
"live": true,
"portal": true,
"checkout": {
"monthly": true,
"yearly": true
},
"yearly_switch": {
"available": true,
"scheduled": {
"schedule_id": "<string>",
"starts_at": "<string>"
},
"needs_support": true
},
"promotion": {
"offer_name": "<string>",
"ends_at": "<string>",
"billing_resumes_at": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}Details
Details
- Callers: an API key, an MCP OAuth token or a Dashboard session.
- Permission: any signed-in member, for their own records; an API key also needs
billing:manage. - Effect: Changes nothing.
- Errors: only the errors any request can get.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Response
Your subscription
free, premium canceling: Premium until current_period_end, then Free. past_due: still Premium while a failed payment is retried. payment_failed: the first payment failed, so still Free
free, active, trialing, canceling, past_due, payment_failed monthly, yearly When the current period ends: the next renewal, the end of a trial, or when Premium ends
False when Stripe couldn't be read, so this is the last stored subscription
The billing portal can open
Which Premium intervals checkout offers
Show child attributes
Show child attributes
Show child attributes
Show child attributes
The free Premium period from a redeemed code, while it runs; else null
Show child attributes
Show child attributes