Subscription billing options

Request#

GET /api/v1/subscriptions/{record}/billing/options

Requires subscriptions:update. See token permissions. Every listed permission is required for this endpoint.

Send Authorization: Bearer YOUR_API_TOKEN and Accept: application/json.

record is the numeric subscription ID in your token’s organization.

Query parameters#

No query parameters are required.

Example#

Set ASSETCENTER_API_TOKEN as described in the quick start. Replace example record and option IDs with values from your organization.

curl --request GET "https://my.assetcenter.app/api/v1/subscriptions/123/billing/options" \
  --header "Authorization: Bearer $ASSETCENTER_API_TOKEN" \
  --header "Accept: application/json"

Response#

200 OK. Example response; IDs, values, and timestamps will differ in your organization.

{
  "data": {
    "billing_type": "subscription",
    "billing_frequencies": [
      "monthly",
      "Quarterly",
      "yearly"
    ],
    "price_models": [
      "lump_sum",
      "per_license"
    ]
  }
}

Behavior and constraints#

Returns fixed allowed values for this action. This response is not paginated.

Errors#

401 means the token is missing, expired, revoked, or not a customer API token. 403 means a required permission or administrator access is missing. 404 means the record or child record is unavailable in this organization. 429 means a rate limit was reached. See error handling and rate limits.