---
title: "List database users"
method: GET
path: "/api/v1/databases/{database_id}/users"
tags: ["Managed Databases"]
---

# List database users

`GET /api/v1/databases/{database_id}/users`

## Request

- Base URL: `https://api.rafftechnologies.com`
- URL: `https://api.rafftechnologies.com/api/v1/databases/{database_id}/users`
- Auth: API key in header `X-API-Key`

The users (roles) inside the database engine, with what each can do. `kind` tells them apart: `admin` is the user created with the database, `scoped` are users you added, `binding` are users Raff created for an app or function, and `system` are engine users you cannot change.

## Path parameters

- `database_id` string, required

## Response `200`

Database users

- object
  - `success` boolean
  - `users` DatabaseUser[]
    - `name` string
    - `role` string: What the user can do, in the engine's terms
    - `scope` string: The database, schema, or keyspace the access applies to
    - `kind` 'admin' | 'scoped' | 'binding' | 'system': `admin` = created with the database; `scoped` = added by you; `binding` = managed by Raff for an app or function; `system` = engine internal

## Other responses

- `401`: Authentication required
- `404`: Resource not found

## Changes

- **2026-10-05** `26292956c4b3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rafftechnologies/apis/raff-api/changes/api/v1/databases/:database_id/users/get.md)

---

[API](https://skmtc.dev/rafftechnologies/apis/raff-api.md) - [All operations](https://skmtc.dev/rafftechnologies/apis/raff-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rafftechnologies/apis/raff-api/revisions/3d30cde0acb4?raw)