---
title: "Retrieve Membership"
method: GET
path: "/memberships/{id}"
tags: ["Memberships"]
---

# Retrieve Membership

`GET /memberships/{id}`

Retrieves a membership by ID or license key. Accessible to the account and to the membership's own user.

## Response `200`

membership retrieved with its recorded phone number

- Membership
  - `account` StorefrontAccount, required
    - `id` string, required — Account ID, prefixed `biz_`.
    - `logo_url` string, nullable, required — Account logo image URL. `null` when the account has not set one.
    - `route` string, required — Account public route identifier — the `whop.com/{route}` storefront path.
    - `title` string, required — Account display name.
  - `cancel_at_period_end` boolean, required — Whether the membership is set to cancel when the current billing period ends. Only meaningful for recurring plans.
  - `created_at` string, required — When the membership was created, as an ISO 8601 timestamp.
  - `current_period_end` string, nullable, required — When the current billing period renews, or when a non-renewing membership expires, as an ISO 8601 timestamp. `null` for one-time purchases with no expiration.
  - `id` string, required — Membership ID, prefixed `mem_`.
  - `license_key` string, nullable, required — The software license key for this membership. Only present when the product includes a software licensing experience.
  - `member` MembershipMember, required
    - `access_level` 'no_access' | 'admin' | 'customer', required — What the member can reach on the account: `customer` for paying members, `admin` for team members, `no_access` once every grant has lapsed.
    - `last_accessed_at` string, nullable, required — When the member last opened the account's content, as an ISO 8601 timestamp. `null` if they never have.
    - `position` number, nullable, required — The member's sort position in the buyer's own account list. `null` until they arrange it.
  - `metadata` object, required — Custom key-value pairs stored on the membership, commonly used for software licensing.
  - `phone_number` string, nullable, required — The buyer's phone number recorded for this membership, or `null`. The number collected (or verified) at checkout when the seller's phone collection is on; falls back to the buyer's account number when they have shared one with this seller.
  - `plan_id` string, required — The plan the buyer purchased, prefixed `plan_`.
  - `product_id` string, required — The product this membership grants access to, prefixed `prod_`.
  - `status` 'trialing' | 'active' | 'past_due' | 'completed' | 'canceled' | 'expired' | 'unresolved', required — Billing state of the membership. `active`/`trialing` memberships grant access; `past_due` is the grace period after a failed payment; `completed` one-time purchases keep access; `canceled`/`expired` do not.
  - `user_id` string, nullable, required — The buyer, prefixed `user_`. `null` when the buyer is another business or the membership is unclaimed.

## Other responses

- `403` — Forbidden
- `404` — Resource not found

## Changes

- **2026-08-27** `16c82685be35` — 1 info
  - added the required property `phone_number` to the response with the `200` status
- **2026-08-07** `f1020c3ecda4` — 2 info
  - added the optional property `error/code` to the response with the `403` status
  - added the optional property `error/code` to the response with the `404` status
- **2026-07-26** `60bbb4a6ffbc` — 21 breaking, 5 warning, 14 info
  - added `#/components/schemas/MembershipMember, subschema #2` to the `member` response property `oneOf` list for the response status `200`
  - the `created_at` response's property type/format changed from `string`/`date-time` to `string`/`` for status `200`
  - the `member` response's property type/format changed from `object, null`/`` to ``/`` for status `200`
  - removed the required property `cancel_option` from the response with the `200` status
  - …36 more

[Change history](https://skmtc.dev/whop/apis/whop-api/changes/memberships/:id/get.md)

---

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