---
title: "Get list of all workspace memberships"
method: GET
path: "/v3/workspace_memberships"
tags: ["Workspaces"]
---

# Get list of all workspace memberships

`GET /v3/workspace_memberships`

## Request

- Base URL: `https://api.affinda.com`
- URL: `https://api.affinda.com/v3/workspace_memberships`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/affinda/apis/affinda-api-2/docs/v3/workspace_memberships/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the memberships of your workspaces.

## Query parameters

- `offset` integer
- `limit` integer
- `workspace` string: Uniquely identify a workspace.
- `user` string

## Response `200`

All matching workspace memberships.

- object
  - `count` integer, required: Number of items in results.
  - `next` string, nullable: URL to request next page of results.
  - `previous` string, nullable: URL to request previous page of results.
  - `results` WorkspaceMembership[], required
    - `identifier` string: Uniquely identify a membership.
    - `workspace` string: Uniquely identify a workspace.
    - `user` User
      - `id` integer: Uniquely identify a user.
      - `name` string
      - `username` string
      - `email` string
      - `avatar` string, nullable: URL of the user's avatar.

## Other responses

- `400`: Bad request. If it is a validation error will contain a list of each invalid field
- `401`: Authorisation error
- `default`: UnexpectedError

## Changes

- **2025-11-20** `978cf99a2ac0`: 2 info
  - api tag `Workspaces` added
  - api tag `Document API - Workspace` removed
- **2024-06-12** `9b7d1081f5bc`: 2 breaking
  - for the `query` request parameter `limit`, default value `300` was removed
  - for the `query` request parameter `limit`, the max was decreased from `300.00` to `100.00`

[Operation history](https://skmtc.dev/affinda/apis/affinda-api-2/changes/v3/workspace_memberships/get.md)

---

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