---
title: "List collaborators"
method: GET
path: "/cases/{case_id}/collaborators"
tags: ["Collaborators"]
---

# List collaborators

`GET /cases/{case_id}/collaborators`

## Request

- Base URL: `https://api.example.com/v1`
- URL: `https://api.example.com/v1/cases/{case_id}/collaborators`
- Auth: none declared

List all users who have been invited to or have access to this case.

## Query parameters

- `status` 'pending' | 'accepted' | 'declined' | 'revoked'
- `role` 'owner' | 'editor' | 'viewer'

## Response `200`

List of collaborators.

- object
  - `data` Collaborator[]
    - `id` string
    - `user_id` string, nullable: User ID if the collaborator has a Sunset account. Null if invite is pending.
    - `email` string, email
    - `first_name` string, nullable
    - `last_name` string, nullable
    - `role` 'owner' | 'editor' | 'viewer': Owner has full control. Editor can modify data. Viewer has read-only access.
    - `status` 'pending' | 'accepted' | 'declined' | 'revoked'
    - `invited_at` string, date-time
    - `accepted_at` string, date-time, nullable
    - `invited_by` string: User ID of the person who sent the invite.
    - `permissions` object: Granular permissions beyond the role.
      - `can_manage_collaborators` boolean
      - `can_manage_documents` boolean
      - `can_manage_financials` boolean
      - `can_manage_probate` boolean
      - `can_use_tools` boolean: Can use phone, email, fax, and notarization tools.
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `404`: Resource not found.

---

[API](https://skmtc.dev/hellosunset/apis/sunset-api.md) - [All operations](https://skmtc.dev/hellosunset/apis/sunset-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hellosunset/apis/sunset-api/revisions/f128e5526efe?raw)