SynqDocs
Management APIUpgrade requests

List the open upgrade requests

Members' open requests to move the org to a plan, oldest first, a page at a time (50 by default). Each closes once the org reaches its plan, or when dismissed. Needs `org.billing.view`.

GET/v1/orgs/{org}/billing/upgrade-requests

Members' open requests to move the org to a plan, oldest first, a page at a time (50 by default). Each closes once the org reaches its plan, or when dismissed. Needs org.billing.view.

Authorization

bearer
AuthorizationBearer <token>

An org API key (sk_live_…, sk_test_…), or an access token from the Synq issuer (the synq brand, on the accounts host) for this API.

In: header

Path Parameters

org*string

The org's id

Match^org_[0-9a-hjkmnp-tv-z]{26}$

Query Parameters

limit?integer

At most this many items, 200 at the most.

Range1 <= value <= 200
Default50
cursor?string

The previous page's next_cursor, for the page after it.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://api.synq.build/v1/orgs/org_01h455vb4pex5vsknk084sn02q/billing/upgrade-requests" \  -H "Authorization: Bearer $SYNQ_API_KEY"
{  "data": [    {      "id": "upr_01h455vb4pex5vsknk084sn02q",      "plan": "pro",      "interval": "month",      "note": "string",      "requested_by": {        "email": "ana@acme.example",        "name": "Acme"      },      "created": "2026-10-21T12:00:00.000Z"    }  ],  "next_cursor": "string"}