---
title: "GET /chiefs"
method: GET
path: "/chiefs"
tags: ["Chief"]
---

# GET /chiefs

`GET /chiefs`

## Request

- Base URL: `https://api.team0.ai/v1`
- URL: `https://api.team0.ai/v1/chiefs`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://clerk.team0.ai/oauth/authorize`, token URL `https://clerk.team0.ai/oauth/token`)
  - HTTP bearer

## Query parameters

- `cursor` string

## Response `200`

Chiefs visible to the current principal.

- ChiefList
  - `data` Chief[], required
    - `id` string, required
    - `object` 'chief', required
    - `kind` 'personal' | 'company', required
    - `name` string, required
    - `capabilities` string[]
  - `next_cursor` string, nullable
  - `has_more` boolean, required

## Other responses

- `304`: The authorized Chief projection has not changed.
- `default`: RFC 9457 problem response. Cross-tenant identity is non-enumerating.

---

[API](https://skmtc.dev/team0/apis/team0-external-api.md) · [All operations](https://skmtc.dev/team0/apis/team0-external-api/llms.txt) · [OpenAPI document](https://skmtc.dev/team0/apis/team0-external-api/revisions/9b838d20a98f?raw)