---
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 type of the membership resource. Possible values are: * `merchant` - merchant account(s) * `organization` - organization(s)
- `status` 'accepted' | 'pending' | 'expired' | 'disabled' | 'unknown' — The status of the membership.
- `resource.type` string — The type of the membership resource. Possible values are: * `merchant` - merchant account(s) * `organization` - organization(s)
- `resource.attributes.sandbox` boolean
- `resource.name` string
- `resource.parent.id` string, nullable
- `resource.parent.type` string — The type of the membership resource. Possible values are: * `merchant` - merchant account(s) * `organization` - organization(s)
- `roles` 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 type 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. Maximum of 64 parameters are allowed in the object.
    - `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 type 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

## Other responses

- `400` — Invalid query parameter combination.
- `401` — Authentication failed or missing required scope.

---

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