---
title: "Everyone in the organization, across every team."
method: GET
path: "/v1/organizations/current/people"
tags: ["organizations"]
---

# Everyone in the organization, across every team.

`GET /v1/organizations/current/people`

## Request

- Base URL: `https://api.50heads.com`
- URL: `https://api.50heads.com/v1/organizations/current/people`
- Auth: HTTP bearer

Organization admins only (403 `organization_admin_required`). Active members of any of its teams, and people its identity provider provisioned (still listed when SCIM turned them off). Each with their teams and roles, SCIM or not, single sign-on linked or not, last sign-in and live sessions; no IP addresses. Ordered by email; `q` matches part of a name or address; page with `nextCursor`.

## Query parameters

- `q` string
- `cursor` string
- `limit` integer

## Response `200`

OK

- OrganizationPeopleResponse
  - `people` object[], required
    - `userId` string, required
    - `name` string, nullable, required
    - `email` string, required
    - `teams` object[], required
      - `workspaceId` string, required
      - `workspaceName` string, required
      - `role` 'owner' | 'admin' | 'member' | 'viewer' | 'billing', required
      - `scimManaged` boolean, required
    - `scim` object, nullable, required
      - `active` boolean, required
    - `ssoLinked` boolean, required
    - `lastSignInAt` string, nullable, required
    - `activeSessions` integer, required
  - `nextCursor` string, nullable, required

## Other responses

- `400`: The request is not valid; `error.details.validation` lists the fixes.
- `401`: No key or token, or it expired or was revoked.
- `403`: The key or token lacks the scope (`insufficient_scope`), or the action is not allowed.
- `429`: Too many requests; wait for Retry-After.

---

[API](https://skmtc.dev/50heads/apis/50heads-api.md) · [All operations](https://skmtc.dev/50heads/apis/50heads-api/llms.txt) · [OpenAPI document](https://skmtc.dev/50heads/apis/50heads-api/revisions/20175e8b00e3?raw)