# POST /api/v1/identity/verify

Auth: public

HTML: https://cooperemail.com/docs/reference/identity-verify

## Summary

Check an agent identity token. No API key. Body is token, audience, and optional consume. Signature, kid, iss, aud, and exp/nbf (30 second skew) are checked, then one indexed lookup confirms the inbox exists and the account is not suspended. consume true makes the jti single-use. A replay is HTTP 200 with valid false and error token_already_used. A bad token is HTTP 200 with valid false and an error code. A malformed body is HTTP 400. Limited to 120 requests a minute per IP. Offline JWKS verification cannot see revocation or single-use. When signing is not configured the route is HTTP 503 identity_unavailable.

## Request

```json
{
  "token": "eyJ...",
  "audience": "https://your-service.example",
  "consume": true
}
```

## Response

The OpenAPI document does not declare a JSON response schema for this call. The summary is the contract.

## Errors

- HTTP 503 identity_unavailable
- HTTP 429 rate_limited

The live `message` is the sentence for that code. Branch on `code`.

```json
{
  "error": {
    "type": "internal_error",
    "code": "identity_unavailable",
    "docs_url": "https://cooperemail.com/docs#identity_unavailable"
  }
}
```

## Idempotency

This route does not document Idempotency-Key or client_id.
