Skip to content
ScoutingAPI
Docs

Error reference

subscription_required

The account tried to buy a top-up (POST /v1/billing/topups) without an active paid subscription. Top-up credits are a SUBSCRIBER add-on — a free / unsubscribed account cannot purchase them.

HTTP 403permission_deniedNot retryable0 credits
HTTP 403error.type = permission_denied

How to fix it

Start a paid plan (starter, pro, or scale) — top-ups become available immediately once a subscription is active. Non-retryable: retrying without upgrading will keep returning this error.

Example response

403 permission_denied
// HTTP 403
{
  "error": {
    "type": "permission_denied",
    "code": "subscription_required",
    "message": "The account tried to buy a top-up (POST /v1/billing/topups) without an active paid subscription. Top-up credits are a SUBSCRIBER add-on — a free / unsubscribed account cannot purchase them.",
    "param": null,
    "requestId": "req_…",
    "creditsCharged": 0,
    "retryable": false,
    "docUrl": "https://scoutingapi.com/docs/errors/subscription_required"
  }
}

This error is free

Like every ScoutingAPI error, subscription_required returns creditsCharged: 0. You are never billed for a failed, empty, blocked or not-found call.

See the full error catalog or the response envelope. The canonical URL for this page is https://scoutingapi.com/docs/errors/subscription_required.