---
title: "Get user agent"
method: GET
path: "/zones/{zoneId}/user-agents/{id}"
tags: ["User Agents"]
---

# Get user agent

`GET /zones/{zoneId}/user-agents/{id}`

## Request

- Base URL: `https://docs.keycard.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.keycard.ai/zones/{zoneId}/user-agents/{id}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Client credentials
    - Token URL: `/service-account-token`

Returns details of a specific user agent by user agent ID

## Path parameters

- `zoneId` string, required
- `id` string, required

## Response `200`

A User Agent represents a user agent (browser, desktop app, CLI tool) that can initiate user sessions via OAuth 2.0 Dynamic Client Registration.

- IamUserAgent: A User Agent represents a user agent (browser, desktop app, CLI tool) that can initiate user sessions via OAuth 2.0 Dynamic Client Registration.
  - `id` string, required: Unique identifier of the user agent
  - `organization_id` string, required: Organization that owns this user agent
  - `zone_id` string, required: Zone this user agent belongs to
  - `slug` string, required: URL-safe identifier, unique within the zone
  - `identifier` string, required: User agent identifier (serves as OAuth client_id). Format: ua:{sha256_hash}
  - `name` string, required: Human-readable name
  - `created_at` string, date-time, required: Entity creation timestamp
  - `updated_at` string, date-time, required: Entity update timestamp

## Other responses

- `404`: Error response
- `default`: Error response

## Changes

- **2026-08-26** `d65d51379d93`: 1 info
  - added the non-success response with the status `404`
- **2026-03-16** `d3d69f45bfed`: 3 info
  - the endpoint scheme security `OAuth2` was added to the API
  - the endpoint scheme security `bearerAuth` was added to the API
  - the endpoint scheme security `iam_bearerAuth` was removed from the API

[Operation history](https://skmtc.dev/keycardai/apis/keycard-ai-keycard-api/changes/zones/:zoneId/user-agents/:id/get.md)

---

[API](https://skmtc.dev/keycardai/apis/keycard-ai-keycard-api.md) - [All operations](https://skmtc.dev/keycardai/apis/keycard-ai-keycard-api/llms.txt) - [OpenAPI document](https://skmtc.dev/keycardai/apis/keycard-ai-keycard-api/revisions/0dee67e0a73a?raw)