GET
/api/v1/billingRead the installation's billing state
Returns the Marketplace billing state of the store that installed your app. Every installed app may call it with any valid access token; no extra scope is required. Gate paid features on `payment_required` and `entitlement`.
No scope required — available to every installed appBearer token
Environments
- SANDBOX
- Authorized local or test environment; no public hosted Sandbox is currently offered.
- PRODUCTION
https://getsas.xyz/api/v1/billing
Request
Headers
| Header | Value | Required |
|---|---|---|
| Authorization | Bearer <ACCESS_TOKEN> | Yes |
Code examples
curl --request GET 'https://getsas.xyz/api/v1/billing' \
--header 'Authorization: Bearer <ACCESS_TOKEN>'Response
200 The billing state of this installation only
{
"description": "The billing state of this installation only",
"headers": {
"RateLimit-Limit": {
"$ref": "#/components/headers/RateLimitLimit"
},
"RateLimit-Remaining": {
"$ref": "#/components/headers/RateLimitRemaining"
},
"RateLimit-Reset": {
"$ref": "#/components/headers/RateLimitReset"
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/InstallationBilling"
}
}
}
}Errors
| 401 | Missing or invalid access token |
| 404 | Marketplace API feature is not enabled for this environment |
| 429 | Fixed-window request limit exceeded for this installation and route key |
| 500 | Internal API failure |
| 503 | Rate-limit service unavailable; request is rejected closed |