---
title: "Get users in an organisation"
method: GET
path: "/v1/organisations/{organisationId}/users"
tags: ["Organisations"]
---

# Get users in an organisation

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

Gets the users under a specific organisation, optionally filtered by username/email address.

## Query parameters

- `q` string
- `limit` integer
- `page` integer

## Response `200`

200 response

- UserAccounts
  - `users` object[], required
    - `id` string, required
    - `username` string, required
    - `avatarUrl` string, required
    - `emailAddress` string, required
    - `links` object, required
      - `self` string, required
      - `teams` string, required
      - `mockApis` string, required
      - `apiTemplateCatalogues` string, required
      - `apiTemplates` string, required
      - `organisation` string, required
  - `meta` PaginationMeta
    - `start` integer, required — The starting index of the current page
    - `end` integer, required — The ending index of the current page
    - `total` integer, required — The total number of items available
    - `page` integer, required — The current page number
    - `totalPages` integer, required — The total number of pages available
  - `links` PaginationLinks
    - `self` string, required — URL path to the user's APIs with optional query parameters

## Other responses

- `401` — 401 Unauthenticated response
- `403` — 403 Unauthorized response
- `404` — 404 Not Found response

---

[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/revisions/93bebefc672f/schema)