Skip to main content
POST
/
api
/
v1
/
tracked-accounts
/
{id}
/
change-tier
Change Tier
curl --request POST \
  --url https://www.catchthegoodones.com/api/v1/tracked-accounts/{id}/change-tier
{
  "account": {
    "id": 1,
    "xHandle": "youraccount",
    "tier": "top"
  },
  "action": "upgraded"
}
Changes the tier of a tracked account. Upgrades are applied immediately with Stripe proration. Downgrades are scheduled for the end of the billing period. Billing note:
  • Upgrades (e.g. starter to pro) take effect immediately. Stripe prorates the difference.
  • Downgrades (e.g. pro to starter) are scheduled. The account continues on the current tier until the billing period ends.

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer ctgo_your_api_key_here
Content-TypeYesapplication/json

​
Path parameters

ParameterTypeDescription
idintegerThe tracked account ID

​
Body

FieldTypeRequiredDescription
newTierstringYes"starter", "growth", or "pro"

​
Example

curl -X POST https://www.catchthegoodones.com/api/v1/tracked-accounts/1/change-tier \
  -H "Authorization: Bearer ctgo_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"newTier": "pro"}'

​
Response

{
  "account": {
    "id": 1,
    "xHandle": "youraccount",
    "tier": "top"
  },
  "action": "upgraded"
}

​
Response fields

FieldTypeDescription
accountobjectThe updated tracked account
actionstring"upgraded", "downgrade_scheduled", or "pending_cancelled"
effectiveAtstringISO 8601 date when a scheduled downgrade takes effect (only for downgrade_scheduled)