---
title: "Get memberships"
method: GET
path: "/api/v2/memberships"
tags: ["Memberships"]
---

# Get memberships

`GET /api/v2/memberships`

List memberships.

## Query parameters

- `filter` union — Filter schema for `membership` list endpoints — pass a single condition or a logical group.
  - object — A logical filter group — combine multiple conditions with the `$op` operator.
    - `$op` 'or' | 'and', required — Logical operator combining conditions in this group. `or` matches records satisfying any condition; `and` requires all conditions to match.
  - FilterMembership — Filter parameters for listing memberships. Supports filtering by target resource type (project, deal, page, dashboard, filter, survey), person, team, access type, and dynamic group. Standard ID and string operators apply.
    - `type_id` union — Filter by the membership type (e.g. person, team, dynamic group).
      - object — Filter using explicit operator syntax.
        - `not_contain` TypeId — unresolved $ref
        - `contains` TypeId — unresolved $ref
        - `not_eq` TypeId — unresolved $ref
        - `eq` TypeId — unresolved $ref
      - TypeId — unresolved $ref
    - `dynamic_group_id` union — Filter by the associated dynamic group.
      - object — Filter using explicit operator syntax.
        - `not_contain` DynamicGroupId — unresolved $ref
        - `eq` DynamicGroupId — unresolved $ref
        - `contains` DynamicGroupId — unresolved $ref
        - `not_eq` DynamicGroupId — unresolved $ref
      - DynamicGroupId — unresolved $ref
    - `access_type_id` union — Filter by the membership access type.
      - AccessTypeId — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `eq` AccessTypeId — unresolved $ref
        - `not_eq` AccessTypeId — unresolved $ref
        - `not_contain` AccessTypeId — unresolved $ref
        - `contains` AccessTypeId — unresolved $ref
    - `id` union — Filter by membership ID.
      - object — Filter using explicit operator syntax.
        - `contains` Id — unresolved $ref
        - `not_eq` Id — unresolved $ref
        - `eq` Id — unresolved $ref
        - `not_contain` Id — unresolved $ref
      - Id — unresolved $ref
    - `agent_id` union — Filter memberships where the target is the specified agent.
      - AgentId — unresolved $ref
      - object — Operator object — supports eq, not_eq, contains, not_contain.
        - `not_eq` AgentId — unresolved $ref
        - `contains` AgentId — unresolved $ref
        - `eq` AgentId — unresolved $ref
        - `not_contain` AgentId — unresolved $ref
    - `dashboard_id` union — Filter by the associated dashboard.
      - object — Filter using explicit operator syntax.
        - `not_contain` DashboardId — unresolved $ref
        - `not_eq` DashboardId — unresolved $ref
        - `contains` DashboardId — unresolved $ref
        - `eq` DashboardId — unresolved $ref
      - DashboardId — unresolved $ref
    - `target_id` union — Filter by the ID of the target resource (used together with target_type).
      - object — Filter using explicit operator syntax.
        - `not_eq` TargetId — unresolved $ref
        - `not_contain` TargetId — unresolved $ref
        - `eq` TargetId — unresolved $ref
        - `contains` TargetId — unresolved $ref
      - TargetId — unresolved $ref
    - `person_id` union — Filter by specific person.
      - PersonId — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `eq` PersonId — unresolved $ref
        - `not_contain` PersonId — unresolved $ref
        - `contains` PersonId — unresolved $ref
        - `not_eq` PersonId — unresolved $ref
    - `deal_id` union — Filter by the associated deal.
      - DealId — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `not_eq` DealId — unresolved $ref
        - `eq` DealId — unresolved $ref
        - `not_contain` DealId — unresolved $ref
        - `contains` DealId — unresolved $ref
    - `page_id` union — Filter by the associated page (doc).
      - object — Filter using explicit operator syntax.
        - `contains` PageId — unresolved $ref
        - `eq` PageId — unresolved $ref
        - `not_eq` PageId — unresolved $ref
        - `not_contain` PageId — unresolved $ref
      - PageId — unresolved $ref
    - `target_type` union — Filter by the type of the target resource (used together with target_id).
      - object — Filter using explicit operator syntax.
        - `not_contain` TargetType — unresolved $ref
        - `not_eq` TargetType — unresolved $ref
        - `eq` TargetType — unresolved $ref
        - `contains` TargetType — unresolved $ref
      - TargetType — unresolved $ref
    - `survey_id` union — Filter by the associated survey.
      - object — Filter using explicit operator syntax.
        - `eq` SurveyId — unresolved $ref
        - `not_contain` SurveyId — unresolved $ref
        - `not_eq` SurveyId — unresolved $ref
        - `contains` SurveyId — unresolved $ref
      - SurveyId — unresolved $ref
    - `meeting_id` union
      - object
        - `not_eq` MeetingId — unresolved $ref
        - `contains` MeetingId — unresolved $ref
        - `not_contain` MeetingId — unresolved $ref
        - `eq` MeetingId — unresolved $ref
      - MeetingId — unresolved $ref
    - `project_id` union — Filter by the associated project.
      - ProjectId — unresolved $ref
      - object — Filter using explicit operator syntax.
        - `eq` ProjectId — unresolved $ref
        - `contains` ProjectId — unresolved $ref
        - `not_eq` ProjectId — unresolved $ref
        - `not_contain` ProjectId — unresolved $ref
    - `filter_id` union — Filter by the associated saved filter.
      - object — Filter using explicit operator syntax.
        - `not_contain` FilterId — unresolved $ref
        - `contains` FilterId — unresolved $ref
        - `eq` FilterId — unresolved $ref
        - `not_eq` FilterId — unresolved $ref
      - FilterId — unresolved $ref
- `sort` string[]

## Headers

- `X-Organization-Id` string, required

## Response `200`

Collection membership

---

[API](https://skmtc.net/productive/apis/api-documentation.md) · [All operations](https://skmtc.net/productive/apis/api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/productive/api-documentation/revisions/11e8576224b8/schema)