---
title: "Service: /self/memberships [GET]"
source: https://dev.pageseeder.com/api/services/list-self-memberships-GET.html
description: "Retrieves memberships for the currently authenticated user, including groups and projects they belong to. Supports filtering by archived status, inherited access, and subgroup memberships."
last_updated: 2026-09-02T11:36:18+10:00
document_type: api_endpoint
operation_id: membership-GET
resource_id: membership
path_template: /self/memberships
http_method: GET
api_category: membership
implementation_version: 6.2004
api_since: 5.0100
deprecated_since: null
obsolete_since: null
api_support: supported
cache_control: private, max-age=0, must-revalidate
generated_at: 2026-09-02
tokens: ~727
---

# /self/memberships \[GET\]

## Description

Get the memberships for the [member](../../reference/glossary/member.md) that is currently authenticated.

### Usage

Use this service when you need to know both the identity and memberships of the user that is currently authenticated. This is often the case, immediately after a user has authenticated and only the session ID or access token is known.

If you already know the username or member ID, you can use the [/members/\{member\}/memberships](list-member-memberships-GET.md) instead.

## Parameters

| Name | Description | Required | Type | Default value |
| --- | --- | --- | --- | --- |
| archived | Whether to return archived projects/groups only | no | boolean | `false` |
| inherited | Whether to return inherited memberships | no | boolean | `false` |
| subgroups | Whether to return memberships from subgroups | no | boolean | `true` |

### archived

By default, this service only returns memberships to groups and projects which are not archived.

Use `archived=true` to only list the memberships to archived groups and projects.

### inherited

When a user is a member of a group, they automatically have guest access to the parent project and ancestor projects. However, unless they are added to the parent projects they are not considered members of those projects.

For example, a membership to `australia-nsw-sydney` provides guest project membership to both `australia` and `australia-nsw` parent projects.

Set the `inherited` parameter to `true` to include the guest project memberships inherited from child group membership.

> **Note:** Inherited memberships do not have the `created` , `email-listed`, `notification` or `id` attributes:  ``` <membership status="normal" role="guest" inherited="true"> ```

### subgroups

The `subgroups` parameter controls whether to include groups that the member has access to because they are a member of one their subgroups.

By default, this parameter is `true` so these groups are included. Set this parameter to `false`, if you do not want to include these groups.

> **Note:** Unless `inherited=true`, setting `subgroups=false` returns only the groups and projects that the user is directly a member of.

## Permission

The user must be authenticated.

## Response

The response includes the `<member>` and the `<membership>` elements are sorted alphabetically based on the name of the group.

```xml
<memberships>
  <member ... />
  <membership ... >
    <group|project ... />
    <details> ... </details>
  </membership>
  <membership ... > ... </membership>
  ...
</memberships>
```

Or in JSON as:

```json
{
  "member": { ... },
  "memberships": [ { ... }, ... ]
}
```

See [/members/\{member\}/memberships](list-member-memberships-GET.md) for examples.

## Error Handling

| Code | Cause / Description |
| --- | --- |
| 0x1029 | A member is not logged in |
| 0x102A | Member not found |