> ## Documentation Index > Fetch the complete documentation index at: https://docs.whop.com/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve Plan > Retrieves the details of an existing plan. ## OpenAPI ````yaml /openapi/api-v1-native.yml get /plans/{id} openapi: 3.1.0 info: title: Whop API description: >- Hand-written V1 endpoints. Merged into the GraphqlRestProxy-generated schema at build time. version: v1 servers: - url: https://{defaultHost} variables: defaultHost: default: api.whop.com/api/v1 security: [] paths: /plans/{id}: parameters: - $ref: '#/components/parameters/ApiVersionDate' - name: id in: path required: true schema: type: string description: Plan ID, prefixed `plan_`. get: tags: - Plans summary: Retrieve Plan description: Retrieves the details of an existing plan. operationId: retrievePlan responses: '200': description: plan retrieved content: application/json: schema: $ref: '#/components/schemas/Plan' '404': $ref: '#/components/responses/NotFound' description: no plan with that id security: - bearerAuth: [] components: parameters: ApiVersionDate: name: Api-Version-Date in: header required: false schema: type: string format: date example: '2026-06-20' description: >- Pins the request to a dated API version. When omitted, the request uses the original (2025-01-01) request/response shapes, so existing unversioned callers are never broken. Generated SDKs always send the latest version they were built against. An unrecognized value is rejected with a 400. The schemas documented here always describe the latest version. schemas: Plan: type: object properties: id: type: string description: Plan ID, prefixed `plan_`. created_at: type: string description: When the plan was created, as an ISO 8601 timestamp. updated_at: type: string description: When the plan was last updated, as an ISO 8601 timestamp. visibility: type: string description: Whether the plan is visible to customers or hidden from public view. enum: - visible - hidden - archived - quick_link example: visible plan_type: type: string description: >- Billing model for this plan: `renewal` (recurring) or `one_time` (single payment). enum: - renewal - one_time example: renewal release_method: type: string description: Sales method for this plan, such as `buy_now` or `waitlist`. enum: - buy_now - waitlist example: buy_now currency: type: string description: Three-letter ISO currency code for this plan's prices. enum: - usd - sgd - inr - aud - brl - cad - dkk - eur - nok - gbp - sek - chf - hkd - huf - jpy - mxn - myr - pln - czk - nzd - aed - eth - ape - cop - ron - thb - bgn - idr - dop - php - try - krw - twd - vnd - pkr - clp - uyu - ars - zar - dzd - tnd - mad - kes - kwd - jod - all - xcd - amd - bsd - bhd - bob - bam - khr - crc - xof - egp - etb - gmd - ghs - gtq - gyd - ils - jmd - mop - mga - mur - mdl - mnt - nad - ngn - mkd - omr - pyg - pen - qar - rwf - sar - rsd - lkr - tzs - ttd - uzs - rub - btc - cny - usdt - kzt - awg - whop_usd - xau example: usd account: type: - object - 'null' description: Account that sells this plan; `null` for standalone invoice plans. product: type: - object - 'null' description: Product this plan belongs to; `null` for standalone plans. invoice: type: - object - 'null' description: >- Invoice this plan was generated for; `null` unless created for an invoice. billing_period: type: - number - 'null' description: >- Recurring billing interval in days, such as 30 for monthly or 365 for annual. `null` for one-time plans. title: type: - string - 'null' description: Plan display name shown to customers. description: type: - string - 'null' description: Customer-visible plan description. purchase_url: type: string description: URL where customers can purchase this plan directly. expiration_days: type: - number - 'null' description: Access duration in days for expiration-based plans. initial_price: type: number description: Initial purchase price in plan currency. renewal_price: type: number description: Recurring price charged every billing period. trial_period_days: type: - number - 'null' description: >- Free trial days before the first renewal charge. `null` if no trial is configured or the user has already used a trial for this plan. three_ds_level: type: - string - 'null' description: 3D Secure behavior for this plan; `null` inherits account default. enum: - mandate_challenge - frictionless - null example: mandate_challenge member_count: type: - number - 'null' description: Active memberships through this plan, when visible to the requester. internal_notes: type: - string - 'null' description: Private notes visible only to authorized team members. metadata: type: - object - 'null' description: Custom key-value pairs stored on the plan. stock: type: - number - 'null' description: Units available for purchase, when visible to the requester. unlimited_stock: type: boolean description: Whether the plan has unlimited stock. split_pay_required_payments: type: - number - 'null' description: Installment payments required before the subscription pauses. adaptive_pricing_enabled: type: boolean description: >- Whether this plan accepts local currency payments via adaptive pricing. payment_method_configuration: type: - object - 'null' description: >- Payment method configuration (`enabled`, `disabled`, `include_platform_defaults`); `null` when plan uses default settings. tax_type: type: string description: How tax is handled for this plan. enum: - inclusive - exclusive - unspecified example: inclusive collect_tax: type: boolean description: Whether tax is collected on purchases of this plan. custom_fields: type: array items: $ref: '#/components/schemas/PlanCustomField' description: Custom input fields collected on the checkout form. required: - id - created_at - updated_at - visibility - plan_type - release_method - currency - account - product - invoice - billing_period - title - description - purchase_url - expiration_days - initial_price - renewal_price - trial_period_days - three_ds_level - member_count - internal_notes - metadata - stock - unlimited_stock - split_pay_required_payments - adaptive_pricing_enabled - payment_method_configuration - tax_type - collect_tax - custom_fields PlanCustomField: type: object properties: id: type: string description: Custom field ID. field_type: type: string description: Custom field input type. enum: - text example: text name: type: string description: Field label shown to customer at checkout. order: type: number description: Field position on checkout form. placeholder: type: - string - 'null' description: Placeholder text shown in empty field. required: type: boolean description: Whether the customer must complete this field to check out. required: - id - field_type - name - order - placeholder - required V1ErrorResponse: type: object properties: error: type: object properties: type: type: string description: Machine-readable error code. message: type: string description: Human-readable error message. required: - type - message required: - error responses: NotFound: description: Resource not found content: application/json: schema: $ref: '#/components/schemas/V1ErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: auth-scheme description: >- An account API key, account scoped JWT, app API key, or user OAuth token. ````