---
title: "Retrieve a single log"
method: GET
path: "/logs/{event_time_and_id}"
tags: ["Logs"]
---

# Retrieve a single log

`GET /logs/{event_time_and_id}`

## Request

- Base URL: `https://api.clerk.com/v1`
- URL: `https://api.clerk.com/v1/logs/{event_time_and_id}`
- Auth: HTTP bearer

Returns a single log entry by its composite key ({event_time_ms}:{event_id}).
Unlike the list endpoint, this returns the full payload for the event.

## Path parameters

- `event_time_and_id` string, required

## Response `200`

A single log entry with full payload.

- LogWithPayload: A log entry representing a recorded event.
  - `object` string, required: String representing the object's type. Always "log".
  - `id` string, uuid, required: Unique identifier for the log event.
  - `event_time` integer, required: The timestamp when the event occurred (Unix timestamp in milliseconds).
  - `actor` string, required: The actor that performed the action (e.g., user ID).
  - `actor_type` string: The kind of principal the `actor` identifies, classified when the event was recorded: `user` (an end user of your application), `dashboard_user` (a member of your Clerk Dashboard workspace), `instance_key`, `api_key`, `integration`, or `clerk_system`.
  - `impersonator` object, nullable: The impersonator that performed the action.
    - `user_id` string, nullable: The user ID of the impersonator.
  - `subject` string, required: The subject of the event (e.g., user ID, resource ID).
  - `type` string, required: The type of the log event.
  - `client_id` string, nullable: The client ID of the request. Set on FAPI requests, unset on BAPI requests.
  - `source` string, nullable, required: The source service that generated the event.
  - `session_id` string, nullable: The ID of the session the event occurred in, if any.
  - `trace_id` string, required: Trace ID for distributed tracing (32 hex characters).
  - `span_id` string, required: Span ID for distributed tracing (16 hex characters).
  - `parent_span_id` string, nullable: Parent span ID for hierarchical tracing.
  - `event_context` LogContext, required: Context information about the environment and device where the event occurred.
    - `environment` LogEnvironmentContext: Environment context for the log event.
      - `type` string, nullable: The environment type (e.g., "development", "production").
      - `application` LogApplicationContext: Application context information.
        - `id` string, nullable: The application ID.
        - `name` string, nullable: The application name.
      - `domain` LogDomainContext: Domain context information.
        - `id` string, nullable: The domain ID.
        - `name` string, nullable: The domain name.
      - `primary_domain` LogDomainContext: Domain context information.
        - `id` string, nullable: The domain ID.
        - `name` string, nullable: The domain name.
    - `device` LogDeviceContext: Device information for the log event.
      - `ip_address` string, nullable: The IP address of the client.
      - `user_agent` string, nullable: The user agent string of the client.
      - `browser` LogBrowserContext: Browser information.
        - `name` string, nullable: The browser name.
        - `version` string, nullable: The browser version.
      - `device_type` string, nullable: The type of device (e.g., "desktop", "mobile", "tablet").
      - `is_mobile` boolean, nullable: Whether the device is a mobile device.
      - `location` LogLocationContext: Geographic location information.
        - `city` string, nullable: The city name.
        - `country` string, nullable: The country, as recorded for the event.
        - `country_code` string: The ISO 3166-1 alpha-2 code of `country`. Omitted when the country cannot be resolved to a known code.
      - `clerk_js_version` string, nullable: The version of Clerk.js used by the client.
      - `is_native` boolean, nullable: Whether the client is a native application.
  - `group_id` string, nullable: The ID of the event group (a flow such as a sign-in) the event belongs to, e.g. a sign-in ID. Null for an event outside any group.
  - `group_type` string, nullable: The kind of event group the event belongs to, e.g. `sign_in`. Null for an event outside any group.
  - `group_started_at` integer, nullable: When the event's group started (Unix timestamp in milliseconds). Null for an event outside any group.
  - `payload` object, required: Additional event-specific data.

## Other responses

- `401`: Authentication invalid
- `403`: Authorization invalid
- `404`: Resource not found
- `429`: Too many requests

## Changes

- **2026-10-30** `8bdc1f8790c7`: 1 info
  - endpoint added
- **2026-09-23** `4c42713b9fc0`: 1 breaking
  - api path removed without deprecation
- **2026-09-22** `dfe0b940d731`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/clerk/apis/clerk-backend-api/changes/logs/:event_time_and_id/get.md)

---

[API](https://skmtc.dev/clerk/apis/clerk-backend-api.md) - [All operations](https://skmtc.dev/clerk/apis/clerk-backend-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clerk/apis/clerk-backend-api/revisions/8bdc1f8790c7?raw)