# Authorization failed

The KeenAuth APIs return this problem type with HTTP status 403 (Forbidden).

## Problem type

| Field | Value |
|---|---|
| Type URI | `https://docs.keenauth.com/errors/authorization_failed` |
| Code | `authorization_failed` |
| HTTP status | 403 Forbidden |
| Title | Authorization failed |

## Meaning

The headless transaction completed but its authorization request ended without a code: consent, legal terms, an organization choice or a new sign-in is needed, or access was denied. The `error` extension carries the OAuth 2.0 error code (RFC 6749 §4.1.2.1).

## Extension members

The response body carries these additional members:

- `error`

## Example response

Example response body. `detail` is a human-readable English description that is not meant for end users; `instance` identifies the request.

```json
{
  "type": "https://docs.keenauth.com/errors/authorization_failed",
  "title": "Authorization failed",
  "status": 403,
  "code": "authorization_failed",
  "detail": "...",
  "instance": "urn:idp:request:<request_id>",
  "error": "..."
}
```

All error codes: [Error reference](/docs/errors).