The codes
| Status | error_code | Cause |
|---|---|---|
| 401 | MISSING_TOKEN | Authorization header missing or not Bearer |
| 401 | INVALID_TOKEN | Malformed JWT or invalid signature |
| 401 | EXPIRED_TOKEN | exp is in the past |
| 401 | TOKEN_NOT_YET_VALID | nbf is in the future |
| 401 | WRONG_AUDIENCE | aud doesn’t match this platform’s platform_id |
| 401 | WRONG_ISSUER | iss isn’t an accepted MudraID issuer (default mudraid-identity; configurable) |
| 403 | MISSING_SCOPE | Token valid but required scope absent |
| 404 | ROUTE_NOT_FOUND | No YAML rule, or skip: true. Indistinguishable on purpose |
| 500 | JWKS_UNAVAILABLE | Couldn’t fetch JWKS to verify. Operator-side, not credential-side |
| 500 | MIDDLEWARE_NOT_READY | YAML couldn’t be loaded or parsed |