---
title: "Retrieve an organisation's mock hosts"
method: GET
path: "/v1/organisations/{organisationId}/hosts"
tags: ["Organisations"]
---

# Retrieve an organisation's mock hosts

`GET /v1/organisations/{organisationId}/hosts`

## Response `200`

Success

- object
  - `mockHosts` MockHostData[], required
    - `id` string, required — The ID of the mock host.
    - `name` string, nullable, required — A human-readable name for the mock host.
    - `friendlyHostname` string — A domain that addresses the mock host.
    - `role` 'DEFAULT' | 'SPECIFIC' — If DEFAULT, new Mock APIs will be automatically assigned to this host if it has fewer than any other host with role DEFAULT
    - `links` object, required
      - `self` string
  - `links` object, required
    - `self` string, required
    - `next` string
    - `previous` string
  - `meta` object, required
    - `start` number, required
    - `end` number, required
    - `total` number, required
    - `page` number, required
    - `totalPages` number, required

---

[API](https://skmtc.net/wiremock/apis/wiremock-cloud.md) · [All operations](https://skmtc.net/wiremock/apis/wiremock-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wiremock/wiremock-cloud/versions/93bebefc672f/schema)