---
title: "List media servers"
method: GET
path: "/media_servers"
tags: ["Media Server"]
---

# List media servers

`GET /media_servers`

Retrieve a collection of media servers

## Query parameters

- `filter` string
- `search` string
- `orderby` string
- `skip` integer
- `top` integer

## Response `200`

OK

- object
  - `count` integer — Total number of resource.
  - `items` object[]
    - `id` string — The unique ID of the resource.
    - `name` string — The name of media server.
    - `type` 'INTERNAL' | 'EXTERNAL' — Every PortSIP PBX has a built-in media server marked as `INTERNAL`; Newly added media servers will be marked as "EXTERNAL".
    - `enabled` boolean — The activate status or deactivated status.
    - `private_ipv4` string — Host IPV4 address.
    - `private_ipv6` string — Host IPV6 address.
    - `public_ipv4` string — Host IPV4 address.
    - `public_ipv6` string — Host IPV6 address.
    - `max_concurrency` integer — Max concurrent sessions.
    - `custom_options` string — Some custom configuration options serialized as json string

## 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)