---
title: "List company memberships"
method: GET
path: "/v1/company_memberships"
tags: ["Company membership"]
---

# List company memberships

`GET /v1/company_memberships`

Returns the memberships of a company (users and pending email invitations),
each including its permissions (`id` and `name` only). The company is
resolved from the `company_id` request parameter; the caller only sees
memberships of companies where they hold the `members_management` permission
(Cardda staff see all).

## Query parameters

- `company_id` string, uuid, required

## Parameters

- `#/paths/~1v1~1users/get/parameters/0` — unresolved $ref

## Response `200`

Paginated list of company memberships.

- CompanyMembership[]
  - `id` string, uuid, required
  - `user_id` string, nullable — Firebase UID of the member. Null while the invitation is still pending.
  - `company_id` string, uuid, required
  - `email` string, nullable
  - `role` string — Role name (e.g. `owner`, `admin`, `member`, or a custom company role name).
  - `status` 'pending' | 'active' | 'canceled'
  - `legal_representative` boolean
  - `has_powers_to_act` boolean, nullable
  - `partner` boolean
  - `partner_type` integer, nullable
  - `participation_rate` number, nullable — Ownership participation percentage (0-100).
  - `is_indirect_participation_corporate` boolean, nullable
  - `company_role_id` string, uuid, nullable
  - `permissions` object[] — Permissions granted to the membership (only `id` and `name` are returned). **Only included by the list endpoint** (`GET /v1/company_memberships`); the create/update/destroy/resend/create_many responses do not embed it.
    - `id` string, uuid
    - `name` string
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401` — Unauthorized
- `404` — Company (from the `company_id` parameter) not found

---

[API](https://skmtc.dev/cardda/apis/banking-api.md) · [All operations](https://skmtc.dev/cardda/apis/banking-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cardda/apis/banking-api/revisions/ff1aeb3fda8b?raw)