---
title: "Find all users."
method: GET
path: "/user-profile/v1/users"
tags: ["Administering user profiles"]
---

# Find all users.

`GET /user-profile/v1/users`

Returns an array containing all users matching the query.<br />User roles: admin

## Query parameters

- `external-id` string, email
- `privacy-notice` string
- `offset` string, int32
- `limit` string, int32
- `include` string

## Response `200`

Returns a (sub-)list of all available users. At most [limit] items are returned.

- object
  - `links` object
    - `self` object, required — URI pointing to this document
      - `href` string, required
      - `methods` string[], required
      - `name` object — Single value object where key is the locale and value is the display name
    - `first` object, required — URI pointing to the first sublist of items of the complete list
      - `href` string, required
    - `prev` object — URI pointing to the previous sublist of items of the complete list
      - `href` string, required
    - `next` object — URI pointing to the next sublist of items of the complete list
      - `href` string, required
  - `offset` integer, required — Number of skipped items, the first item in this sublist list will be (offset)
  - `limit` integer, required — Maximum number of items in the current sublist

## Other responses

- `400` — Response indicating a client error.
- `429` — Too Many Requests, the server has reached a limit, the request must be sent again at a later time.

---

[API](https://skmtc.net/goacoustic/apis/acoustic-content-api.md) · [All operations](https://skmtc.net/goacoustic/apis/acoustic-content-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/goacoustic/acoustic-content-api/versions/677305266d89/schema)