Skip to content
ScoutingAPI
Docs

Error reference

invalid_api_key

The Authorization header is present but the key is unknown or malformed.

HTTP 401authentication_errorNot retryable0 credits
HTTP 401error.type = authentication_error

How to fix it

Check the key value and that its env (test/live) matches the surface.

Example response

401 authentication_error
// HTTP 401
{
  "error": {
    "type": "authentication_error",
    "code": "invalid_api_key",
    "message": "The Authorization header is present but the key is unknown or malformed.",
    "param": null,
    "requestId": "req_…",
    "creditsCharged": 0,
    "retryable": false,
    "docUrl": "https://scoutingapi.com/docs/errors/invalid_api_key"
  }
}

This error is free

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