---
title: "Get Agent"
method: GET
path: "/agents/{id}"
tags: ["Agents", "Agent"]
---

# Get Agent

`GET /agents/{id}`

## Request

- Base URL: `https://developers.chatway.app/api/v1`
- URL: `https://developers.chatway.app/api/v1/agents/{id}`
- Auth: API key in header `X-API-KEY`

Retrieve one agent's profile, availability and team role. Obtain the agent ID from data[].id in List Agents, then pass it in the GET /agents/{id} path.

## Path parameters

- `id` string, required

## Response `200`

- union
  - object
    - `data` object, required
      - `type` string, required
      - `id` string, required
      - `attributes` object, required
        - `email` string, nullable, required
        - `name` string, nullable, required
        - `status` string, nullable, required
        - `online_status` string, nullable, required
        - `profile_photo_url` string, nullable, required
        - `resized_profile_photo_url` string, nullable, required
        - `role` string, nullable, required
  - object

## Other responses

- `403`: Authorization error

---

[API](https://skmtc.dev/chatway/apis/chatway-developer-docs.md) · [All operations](https://skmtc.dev/chatway/apis/chatway-developer-docs/llms.txt) · [OpenAPI document](https://skmtc.dev/chatway/apis/chatway-developer-docs/revisions/ca1a1da291cc?raw)