---
title: "List a service's hosts"
description: "Returns the service's host assignments with each host's member identity embedded."
api_method: GET
api_path: "/v1/services/{serviceId}/hosts"
canonical_url: https://wiblo.app/docs/developers/api/hosts/list-service-hosts
last_updated: 2026-07-28T17:56:11+02:00
md_url: https://wiblo.app/docs/developers/api/hosts/list-service-hosts.md
---

# List a service's hosts

`GET /v1/services/{serviceId}/hosts`

Returns the service's host assignments with each host's member identity embedded. Available to any active member. Per-user rate-limited at 60/60s.

## Path parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `serviceId` | `string` | Yes |  |

## Headers

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `X-Wiblo-Workspace` | `string` | Yes | Workspace id the call is scoped to. The actor must hold an active membership in it; a foreign or unknown id collapses onto 404 WORKSPACE_NOT_FOUND. |

## Request

**curl**

```bash
curl https://api.wiblo.app/v1/services/3f8a2b9c-51d4-4e0b-9c6a-7d2e8f1a4b5c/hosts \
  -H "Authorization: Bearer $WIBLO_TOKEN" \
  -H "X-Wiblo-Workspace: $WIBLO_WORKSPACE_ID"
```

**TypeScript**

```ts
import { createSdk, listServiceHosts } from "@workspace/sdk"

const sdk = createSdk({ baseUrl: "https://api.wiblo.app" })

const { data, error } = await listServiceHosts({
  client: sdk,
  path: { serviceId: "3f8a2b9c-51d4-4e0b-9c6a-7d2e8f1a4b5c" },
  headers: { "X-Wiblo-Workspace": "..." },
})
```

## Example response

```json
{
  "hosts": [
    {
      "id": "a1e5c3d7-2b8f-4c6a-9d4e-7f1b3a5c8e2d",
      "service_id": "3f8a2b9c-51d4-4e0b-9c6a-7d2e8f1a4b5c",
      "member_id": "5f2d8c1b-7e4a-4b9d-a6c3-1d8e5f2a7b4c",
      "role": "organizer",
      "is_fixed": true,
      "priority": null,
      "weight": null,
      "created_at": "2026-06-12T09:40:00.000Z",
      "updated_at": "2026-06-12T09:40:00.000Z",
      "member": {
        "id": "5f2d8c1b-7e4a-4b9d-a6c3-1d8e5f2a7b4c",
        "name": "Amara Okafor",
        "email": "amara@example.com",
        "avatar_url": null
      }
    },
    {
      "id": "c7b2e9f4-6d1a-4f8b-b3c5-9e2d7a4f6c1b",
      "service_id": "3f8a2b9c-51d4-4e0b-9c6a-7d2e8f1a4b5c",
      "member_id": "8b3e6d2a-4c7f-4e1b-9d5a-2f6c8e3b7a1d",
      "role": "host",
      "is_fixed": false,
      "priority": null,
      "weight": 200,
      "created_at": "2026-07-20T11:30:00.000Z",
      "updated_at": "2026-07-20T11:30:00.000Z",
      "member": {
        "id": "8b3e6d2a-4c7f-4e1b-9d5a-2f6c8e3b7a1d",
        "name": "Jonas Weber",
        "email": "jonas@example.com",
        "avatar_url": null
      }
    }
  ]
}
```

## Responses

**`200`** — The service's hosts. Returns `HostListResponse`.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `hosts` | `array<HostResponse>` | Yes |  |

**`401`** — No valid session cookie or `wbl_*` bearer was present. Returns `ApiErrorEnvelope`.

**`404`** — No service visible to the actor with this id in this workspace (`SERVICE_NOT_FOUND`). Returns `ApiErrorEnvelope`.

**`422`** — Path param failed UUID validation (`INVALID_PARAMS`). Returns `ApiErrorEnvelope`.

**`429`** — Rate limit exceeded. The body's `error.code` is `RATE_LIMITED` and `error.details.retry_after` is the same number of seconds as the `Retry-After` header. Returns `ApiErrorEnvelope`.

### The HostResponse object

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `string` | Yes |  |
| `service_id` | `string` | Yes |  |
| `member_id` | `string` | Yes |  |
| `role` | `"organizer" \| "host"` | Yes |  |
| `is_fixed` | `boolean` | Yes |  |
| `priority` | `integer \| null` | Yes |  |
| `weight` | `integer \| null` | Yes |  |
| `created_at` | `string` | Yes |  |
| `updated_at` | `string` | Yes |  |
| `member` | `object` | Yes |  |
| `member.id` | `string` | Yes |  |
| `member.name` | `string` | Yes |  |
| `member.email` | `string \| null` | Yes |  |
| `member.avatar_url` | `string \| null` | Yes |  |