---
title: "List ring group agents"
method: GET
path: "/ring_groups/{id}/agents"
tags: ["Ring Group"]
---

# List ring group agents

`GET /ring_groups/{id}/agents`

Retrieve a collection of ring group agents.

## Path parameters

- `id` string, required — The unique ID of the resource.

## Response `200`

OK

- object
  - `items` object[]
    - `extension_number` string — The extension number.
    - `display_name` string — The display name of user.
    - `skill_level` integer — The skill level of agent in ring group. Only valid when `ring_strategy` is skill based.

## Other responses

- `4XX` — Error

---

[API](https://skmtc.net/portsip/apis/portsip-pbx-rest-api.md) · [All operations](https://skmtc.net/portsip/apis/portsip-pbx-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/portsip/portsip-pbx-rest-api/revisions/577415d4a3d5/schema)