---
title: "List authentication requests"
method: GET
path: "/api/v1/logs/authentication/requests"
tags: ["Authentication Logs"]
---

# List authentication requests

`GET /api/v1/logs/authentication/requests`

Returns a paginated list of authentication request logs for the current environment, ordered most-recent first. Use this endpoint to audit login activity, investigate failed authentications. Filter by email, status (INITIATED, PENDING, SUCCESS, FAILED), time window, resource ID, or client ID. Status filters are case-insensitive. The response includes cursor tokens for forward and backward pagination and the total matching count. Pass next_page_token or prev_page_token as page_token on the next call to page through results.

## Query parameters

- `page_size` integer
- `page_token` string
- `email` string
- `status` string[]
- `start_time` string, date-time
- `end_time` string, date-time
- `resource_id` string
- `client_id` string

## Response `200`

Authentication requests page returned successfully; includes authRequests, pagination tokens, and total_size

- AuditlogsListAuthLogResponse
  - `authRequests` AuditlogsAuthLogRequest[] — Authentication requests matching the filter, ordered most-recent first. Empty when no events match.
    - `auth_request_id` string — Unique identifier for this authentication request.
    - `client_id` string — Unique identifier of the client associated with this authentication event
    - `client_name` string — Display name of the client
    - `client_type` string — Type of the client application (e.g., ENV, NTV, SPA, M2M)
    - `connection_details` AuditlogsConnectionDetails[] — Connections involved in this authentication request, including provider and organization context.
      - `connection_id` string — Connection ID for this connection detail entry.
      - `connection_provider` string — Identity provider for this connection.
      - `connection_type` string — Connection type (for example OIDC or SAML).
      - `organization_id` string — Organization that owns this connection.
    - `connection_id` string — Primary connection ID used for this authentication request.
    - `connection_provider` string — Identity provider for the primary connection (for example OKTA or GOOGLE).
    - `connection_type` string — Type of the primary connection (for example OIDC or SAML).
    - `email` string — End-user email associated with the authentication attempt, when available.
    - `environment_id` string — Environment ID where the authentication request occurred.
    - `organization_id` string — Organization ID associated with this authentication request, when resolved.
    - `resource_id` string — Resource identifier associated with this authentication request, when present.
    - `resource_name` string — Display name of the resource associated with this authentication request, when present.
    - `resource_type` string — Type of the resource associated with this authentication request, when present.
    - `status` 'INITIATED' | 'PENDING' | 'SUCCESS' | 'FAILED' — Outcome of the authentication request: INITIATED, PENDING, SUCCESS, or FAILED.
    - `timestamp` string, date-time — UTC timestamp when this authentication request was recorded.
    - `workflow` string — Authentication workflow that produced this log entry, when available.
  - `next_page_token` string — Opaque cursor for the next page. Empty when the current page is the last. Pass back as page_token to fetch the next page.
  - `prev_page_token` string — Opaque cursor for the previous page. Empty when the current page is the first. Pass back as page_token to fetch the previous page.
  - `total_size` integer — Total number of authentication requests matching the filter across all pages.

## Other responses

- `400` — Invalid request - page_token is malformed, or status filter value is not one of INITIATED, PENDING, SUCCESS, or FAILED
- `401` — Missing or invalid Authorization header

---

[API](https://skmtc.net/scalekit/apis/scalekit-api-reference.md) · [All operations](https://skmtc.net/scalekit/apis/scalekit-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scalekit/scalekit-api-reference/versions/a40d5d4650e5/schema)