Get authentication statistics

GET

/api/admin/stats/auth

Code sample: Shell / cURL

curl --request GET \
  --url 'https://auth.example.com/api/admin/stats/auth?from=2026-04-15T12%3A00%3A00Z&to=2026-04-15T12%3A00%3A00Z' \
  --header 'Authorization: Bearer <token>'

Returns authentication and token audit counts for a required time period, optionally filtered by client ID.

Authorizations

• adminBearer
• adminSessionCookie

Parameters

Query Parameters

from

required

string format: date-time

Inclusive start of the statistics period.

to

required

string format: date-time

Inclusive end of the statistics period.

client_id

string

Optional client ID filter.

Responses

200

Authentication and token audit statistics for the requested period.

Media type application/json

object

total_attempts

integer

successful

integer

failed

integer

success_rate

number

mfa_used

integer

by_grant_type

object

key

additional properties

object

successful

integer

failed

integer

key

additional properties

period

object

from

string format: date-time

to

string format: date-time

key

additional properties

key

additional properties

Example

{
  "total_attempts": 1280,
  "successful": 1236,
  "failed": 44,
  "success_rate": 96.56,
  "mfa_used": 312,
  "by_grant_type": {
    "authorization_code": {
      "successful": 900,
      "failed": 20
    },
    "client_credentials": {
      "successful": 336,
      "failed": 24
    }
  },
  "period": {
    "from": "2026-06-01T00:00:00.000Z",
    "to": "2026-06-02T00:00:00.000Z"
  }
}

400

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

401

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

403

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}