# List users

Get `https://app.mk.io/api/v1/organization/users`

This endpoint shows the details of all users with access to this organization in MK.IO.

**RBAC Capability Required:** `core.user.get`

## Authentication

**Authorization** Bearer

Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Response

**200 OK**

- **kind** `string` Required  
  The kind of record.
- **value** `list of objects [UserBriefSchema](https://docs.mediakind.com/api-reference/management-api/schemas/userbriefschema)` Required  
  List of users  
  - **kind** `string` Optional  
    The kind of record.
  - **metadata** `object [UserMetadata](https://docs.mediakind.com/api-reference/management-api/schemas/usermetadata)` Required  
    Metadata.
    - **id** `string` Required format: uuid  
      The unique identifier of the user.
    - **spec** `object [UserBriefSpec](https://docs.mediakind.com/api-reference/management-api/schemas/userbriefspec)` Required  
      Specification.
      - **avatar** `string` Required <=200 characters  
        Avatar.
      - **email** `string` Required 1-1024 characters  
        Contact email address
      - **name** `string` Required 1-1024 characters  
        Full name.

## Errors

**400 Bad Request**

- **error** `object [ErrorDetail](https://docs.mediakind.com/api-reference/management-api/schemas/errordetail)` Required  
  Pertinent information about the error  
  - **code** `string` Required  
  - **detail** `string` Required  
  - **extraDetail** `map from strings to any` Optional  
    Extra information regarding this error.  
  - **ref** `string` Required  
    A reference to the request that caused the error.
  - **status** `integer` Required  
    The HTTP status code

**401 Unauthorized**  
**403 Forbidden**  
**404 Not Found**  
**429 Too Many Requests**  
**500 Internal Server Error**  
Each of these error responses follows the same format as 400 Bad Request, with the respective error codes and messages.