Error reference

email_unverified

The API key is valid, but the account email has not been verified yet — so LIVE credit (calls made with a scout_live_ key) is locked until you confirm your email (§7.5.1). Your scout_test_ sandbox key is unaffected and keeps returning deterministic fixtures at zero cost.

HTTP 403permission_deniedNot retryable0 credits

HTTP 403error.type = permission_denied

How to fix it

Verify your account email to unlock live credits — open the verification link sent when you signed up, or resend it from your dashboard. Live calls succeed immediately once your email is confirmed; in the meantime keep building against your scout_test_ sandbox key, which never requires verification and never costs a credit.

Example response

403 permission_denied

// HTTP 403
{
  "error": {
    "type": "permission_denied",
    "code": "email_unverified",
    "message": "Live credits are locked until your account email is verified. The sandbox (scout_test_) remains available.",
    "param": null,
    "requestId": "req_…",
    "creditsCharged": 0,
    "retryable": false,
    "docUrl": "https://scoutingapi.com/docs/errors/email_unverified"
  }
}

This error is free

Like every ScoutingAPI error, email_unverified 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/email_unverified.