---
title: "Retrieve membership"
method: GET
path: "/api/v1/organization_groups/{organizationGroupID}/memberships/{membershipID}"
tags: ["Membership"]
---

# Retrieve membership

`GET /api/v1/organization_groups/{organizationGroupID}/memberships/{membershipID}`

## Request

- Base URL: `https://example.rossum.app`
- URL: `https://example.rossum.app/api/v1/organization_groups/{organizationGroupID}/memberships/{membershipID}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/rossum/apis/rossum-api/docs/api/v1/organization_groups/:organizationGroupID/memberships/:membershipID/get.ts> (a function with typed inputs; its response is checked against the schema)

Get a membership object.

## Path parameters

- `membershipID` integer, required
- `organizationGroupID` integer, required

## Response `200`

OK

- Membership
  - `id` integer, required: ID of the membership
  - `url` string, uri, required: URL of the membership
  - `user` string, uri, required: User URL.
  - `organization` string, uri, required: Organization URL.
  - `queues` string[], required: URLs of queues user has access to
  - `expires_at` string, date-time, nullable, required: Timestamp of membership expiration. Membership won't expire if no expiration is set.

## Other responses

- `400`: Invalid input data.
- `401`: The username/password is invalid or token is invalid (e.g. expired).
- `403`: Insufficient permission, missing authentication, invalid CSRF token and similar issue.
- `404`: The specified resource was not found.
- `409`: Conflict
- `429`: Request rate is too high, wait before sending more requests. See [Rate Limiting](/guides/overview#rate-limiting) for more details.
- `500`: Server failure while processing the request.
- `502`: Invalid response from the upstream server.
- `503`: We're temporarily offline for maintenance. Please try again later.
- `504`: Upstream server could not complete the request in time.

## Changes

- **2026-09-01** `f1b5a910991d`: 1 breaking, 6 warning, 1 info
  - the response's body type changed from `object` to no type for status `200`
  - removed the optional property `expires_at` from the response with the `200` status
  - removed the optional property `id` from the response with the `200` status
  - removed the optional property `organization` from the response with the `200` status
  - …4 more

[Operation history](https://skmtc.dev/rossum/apis/rossum-api/changes/api/v1/organization_groups/:organizationGroupID/memberships/:membershipID/get.md)

---

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