---
title: "Search entity users"
method: GET
path: "/entity/{entityId}/users"
tags: ["entity > user"]
---

# Search entity users

`GET /entity/{entityId}/users`

## Request

- Base URL: `https://api.mercoa.com`
- URL: `https://api.mercoa.com/entity/{entityId}/users`
- Auth: HTTP bearer

Search entity users

## Path parameters

- `entityId` string, required

## Query parameters

- `foreignId` string
- `role` string
- `name` string
- `email` string
- `limit` integer
- `startingAfter` string

## Response `200`

Response with status 200

- EntityTypesFindEntityUserResponse
  - `count` integer, required: Total number of users for the given filters. This value is not limited by the limit parameter. It is provided so that you can determine how many pages of results are available.
  - `hasMore` boolean, required: True if there are more users available for the given filters.
  - `data` EntityTypesEntityUserResponse[], required
    - `id` string, required
    - `foreignId` string: The ID used to identify this user in your system.
    - `email` string
    - `name` string
    - `roles` string[], required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required

## Other responses

- `400`: Error response with status 400
- `401`: Error response with status 401
- `403`: Error response with status 403
- `404`: Error response with status 404
- `409`: Error response with status 409
- `500`: Error response with status 500
- `501`: Error response with status 501

---

[API](https://skmtc.dev/mercoa/apis/mercoa-2.md) - [All operations](https://skmtc.dev/mercoa/apis/mercoa-2/llms.txt) - [OpenAPI document](https://skmtc.dev/mercoa/apis/mercoa-2/revisions/00a8e403ae18?raw)