---
title: "List memberships"
method: GET
path: "/v0.1/memberships"
tags: ["Memberships"]
---

# List memberships

`GET /v0.1/memberships`

List memberships of the current user.

## Query parameters

- `offset` integer
- `limit` integer
- `kind` string — The kind of the membership resource. Possible values are: * `merchant` - merchant account(s) * `organization` - organization(s)
- `resource.attributes.sandbox` boolean
- `resource.name` string

## Response `200`

Returns a list of Membership objects.

- object
  - `items` Membership[], required
    - `id` string, required — ID of the membership.
    - `resource_id` string, required — ID of the resource the membership is in.
    - `type` string, required — The kind of the membership resource. Possible values are: * `merchant` - merchant account(s) * `organization` - organization(s)
    - `roles` string[], required — User's roles.
    - `permissions` string[], required — User's permissions.
    - `created_at` string, date-time, required — The timestamp of when the membership was created.
    - `updated_at` string, date-time, required — The timestamp of when the membership was last updated.
    - `invite` Invite — Pending invitation for membership.
      - `email` string, email, required — Email address of the invited user.
      - `expires_at` string, date-time, required
    - `status` 'accepted' | 'pending' | 'expired' | 'disabled' | 'unknown', required — The status of the membership.
    - `metadata` Metadata — Set of user-defined key-value pairs attached to the object. Partial updates are not supported. When updating, always submit whole metadata.
    - `attributes` Attributes — Object attributes that are modifiable only by SumUp applications.
    - `resource` MembershipResource, required — Information about the resource the membership is in.
      - `id` string, required — ID of the resource the membership is in.
      - `type` string, required — The kind of the membership resource. Possible values are: * `merchant` - merchant account(s) * `organization` - organization(s)
      - `name` string, required — Display name of the resource.
      - `logo` string, uri — Logo fo the resource.
      - `created_at` string, date-time, required — The timestamp of when the membership resource was created.
      - `updated_at` string, date-time, required — The timestamp of when the membership resource was last updated.
      - `attributes` Attributes — Object attributes that are modifiable only by SumUp applications.
  - `total_count` integer, required

## Changes

- **2025-10-29** `4dc4b073a6a9` — 1 breaking
  - the response property `items/items/resource/attributes` became optional for the status `200`
- **2025-10-02** `c7df85140547` — 1 breaking, 3 info
  - removed the enum value `merchant` from the `query` request parameter `kind`
  - response property `items/items/permissions` deprecated
  - removed the `merchant` enum value from the `items/items/resource/type` response property for the response status `200`
  - removed the `merchant` enum value from the `items/items/type` response property for the response status `200`
- **2025-07-14** `a16feb855ba1` — 1 info
  - added the new optional `query` request parameter `resource.name`
- **2025-03-13** `3bbba954835d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/sumup/apis/sumup-rest-api/changes/v0.1/memberships/get.md)

---

[API](https://skmtc.dev/sumup/apis/sumup-rest-api.md) · [All operations](https://skmtc.dev/sumup/apis/sumup-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sumup/sumup-rest-api/revisions/d32eef8a3bd2/schema)