Organizations

List project users with metadata

Get all users in a project with metadata (email, full name, role, accountStatus, etc.). Optional query `status` filters by accountStatus. Project must belong to the organization. Requires owner or admin role.

AuthBearer (JWT)
GroupOrganizations
Rate limitSee Rate Limits
GET/api/orgs/{orgId}/projects/{projectId}/users

SDK setup

Create a client and set credentials (JWT and/or API key) before calling the API. Match the authentication type shown above.

import { Configuration, OrganizationsApi } from 'mudbase-sdk';

const configuration = new Configuration({
  basePath: 'https://cloud.mudbase.dev',
  accessToken: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c3JfbW9yZ2FuX2RlIiwiZW1haWwiOiJtb3JnYW4uY2hlbkBub3J0aHdpbmQuZGV2IiwiZXhwIjoxODI1MTI5NjAwfQ.doc_preview_sig',
});

const organizations = new OrganizationsApi(configuration);
import { Configuration, OrganizationsApi } from 'mudbase-sdk';

const configuration = new Configuration({
  basePath: 'https://cloud.mudbase.dev',
  accessToken: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c3JfbW9yZ2FuX2RlIiwiZW1haWwiOiJtb3JnYW4uY2hlbkBub3J0aHdpbmQuZGV2IiwiZXhwIjoxODI1MTI5NjAwfQ.doc_preview_sig',
});

const organizations = new OrganizationsApi(configuration);

Example request

Call this endpoint using the client from SDK setup. Use View HTTP for a raw cURL example.

const { data: result } = await organizations.getProjectUsers("usr_hdOB4viBLgiOcP", "usr_QUAJmchGZEBuba");
const { data: result } = await organizations.getProjectUsers("usr_hdOB4viBLgiOcP", "usr_QUAJmchGZEBuba");

Playground

live

Test this endpoint with your own credentials. Your requests will be sent to the live API.

Use the auth endpoints to obtain a JWT.

No Request Yet

Send a request to see the full inspector

Authentication

Requires JWT
Note
Include your JWT in the Authorization: Bearer YOUR_TOKEN header (user-facing apps, RBAC). View authentication guide →

Path Parameters

NameTypeRequiredDescription
orgIdstringYes—
projectIdstringYes—

Query Parameters

NameTypeRequiredDescription
statusstringNoFilter by account status (pending, active, suspended)

Responses

200Project users with metadata
json
{
  "users": [
    {
      "_id": "usr_KOtgjvnSUw6ia9",
      "firstName": "Alexanne",
      "lastName": "Hansen",
      "email": "gregory_huel@northwind.dev",
      "avatar": "https://picsum.photos/seed/bplGH0/491/1755",
      "emailVerified": false,
      "role": "port generate",
      "customRole": "application back up",
      "phone": "733.287.6979 x6602",
      "phoneVerified": false,
      "lastLogin": "2026-07-18T10:04:46.918Z",
      "isActive": true,
      "accountStatus": "suspended",
      "isAnonymous": true,
      "createdAt": "2026-06-28T08:36:31.616Z",
      "project": {
        "_id": "usr_LN7GDIqhZoOYT2",
        "name": "Guadalupe Okuneva",
        "slug": "unlucky-traditionalism-dzoz"
      }
    }
  ],
  "total": 219,
  "project": {
    "_id": "6BhIqGnGRVV9Zyb6",
    "name": "Russell Olson",
    "slug": "ashamed-comparison-qehe"
  }
}
{
  "users": [
    {
      "_id": "usr_KOtgjvnSUw6ia9",
      "firstName": "Alexanne",
      "lastName": "Hansen",
      "email": "gregory_huel@northwind.dev",
      "avatar": "https://picsum.photos/seed/bplGH0/491/1755",
      "emailVerified": false,
      "role": "port generate",
      "customRole": "application back up",
      "phone": "733.287.6979 x6602",
      "phoneVerified": false,
      "lastLogin": "2026-07-18T10:04:46.918Z",
      "isActive": true,
      "accountStatus": "suspended",
      "isAnonymous": true,
      "createdAt": "2026-06-28T08:36:31.616Z",
      "project": {
        "_id": "usr_LN7GDIqhZoOYT2",
        "name": "Guadalupe Okuneva",
        "slug": "unlucky-traditionalism-dzoz"
      }
    }
  ],
  "total": 219,
  "project": {
    "_id": "6BhIqGnGRVV9Zyb6",
    "name": "Russell Olson",
    "slug": "ashamed-comparison-qehe"
  }
}
401—
403—
404—

Errors

CodeMeaning
401—
403—
404—
Run in PostmanDownload OpenAPI

Next

NEXT →API Reference OverviewBase URL, rate limits, pagination, and the full endpoint index.NEXT →AuthenticationAPI keys, Bearer tokens, and user sessions.NEXT →API PlaygroundSearch any endpoint and send a live request.
Edit this page on GitHub