---
title: "Get agent"
method: GET
path: "/beta/agents/{agentId}"
tags: ["Agents"]
---

# Get agent

`GET /beta/agents/{agentId}`

Get an agent/admin by id.

## Path parameters

- `agentId` string, uuid, required

## Response `200`

The agent/admin

- AgentOutput
  - `data` Agent, required
    - `id` string, uuid, required — Unique identifier for the agent
    - `createdAt` string, date-time, required — Time when the agent was created
    - `displayName` string, required — The agent's display name
    - `email` string, required — The agent's primary email address
    - `avatarUrl` string — The url from which to load the agent's avatar
    - `phoneNumber` string — The agent's primary phone number
    - `additionalEmails` string[] — Additional email addresses for the agent
    - `additionalPhoneNumbers` string[] — Additional phone numbers for the agent
    - `firstName` string — The agent's first name
    - `lastName` string — The agent's last name
    - `middleNames` string[] — The agent's middle names
    - `roles` string[] — The agent's roles

## Other responses

- `400` — Invalid value for: path parameter agentId, Invalid value extracted from request context
- `404` — An entity in this request could not be found
- `500` — Internal failure during request processing

---

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