> ## Documentation Index > Fetch the complete documentation index at: https://codebeans-wishlyst.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Who this list is shared with ## OpenAPI ````yaml api-reference/openapi.json GET /wishlists/{wishlistId}/shares openapi: 3.1.0 info: title: Codebeans Wishlyst Shopper API version: 1.0.0 summary: Versioned REST API for shopper-facing mobile apps and custom storefronts. description: >- All paths are relative to the base URL shown in the Shopify admin under Wishlist settings > API Settings (https://{host}/api/v1). Every response carries an `API-Version` header. Errors are RFC 9457 `application/problem+json`. servers: - url: https://{host}/api/v1 description: Base URL from Wishlist settings > API Settings variables: host: default: codebeans-wishlist.cblyst.com description: App host security: - ApiKey: [] Shop: [] CustomerId: [] - ApiKey: [] Shop: [] SessionId: [] tags: - name: Settings description: Shop-level widget settings, feature switches and plan. - name: Wishlists description: The shopper's own lists. - name: Items description: Products inside one list. - name: Product description: Product-page heart and Add-to-wishlist picker. - name: Shared lists description: Shared With Me / Shared By Me tabs, opening and saving a shared list. - name: Sharing description: Share one of the shopper's lists by email or link, and stop sharing. - name: Account description: Post-login guest list claim. - name: Meta description: The machine-readable spec. paths: /wishlists/{wishlistId}/shares: parameters: - $ref: '#/components/parameters/wishlistId' get: tags: - Sharing summary: Who this list is shared with operationId: listShares responses: '200': description: Shares content: application/json: example: data: shares: - id: 689 email: priya@example.com status: active itemCount: 2 scoped: true saved: false createdAt: '2026-10-07T11:54:26.059Z' revokedAt: null variantIds: - '44986123976757' viewers: - id: 702 variantIds: null links: active: 1 saves: 0 meta: planFeatures: wishlistSharing: true shareViaEmail: true '400': $ref: '#/components/responses/MalformedRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '410': $ref: '#/components/responses/Gone' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/InternalError' components: parameters: wishlistId: name: wishlistId in: path required: true schema: type: string pattern: ^\d+$ example: '52' description: Numeric wishlist id. responses: MalformedRequest: description: >- MALFORMED_REQUEST: body is not a JSON object, or a numeric path id is not a number. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' example: title: Malformed request status: 400 code: MALFORMED_REQUEST message: wishlistId must be a number. messageKey: null Unauthorized: description: >- UNAUTHENTICATED (bad or missing key/shop), CUSTOMER_REQUIRED (no or unknown shopper), or SHARE_LOGIN_REQUIRED. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' example: title: Unauthenticated status: 401 code: UNAUTHENTICATED message: Invalid API Key messageKey: null Forbidden: description: >- API_ACCESS_NOT_IN_PLAN, GUEST_DISABLED, FEATURE_NOT_IN_PLAN, PAGE_DISABLED, PLAN_LIMIT_REACHED, WISHLIST_PRIVATE, NOT_OWNER, SHARE_LINK_TAKEN or SHARE_EMAIL_MISMATCH. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' example: title: Guest disabled status: 403 code: GUEST_DISABLED message: Please log in to save items to your wishlist. messageKey: error_guest_login_required Gone: description: SHARE_REVOKED or VERSION_RETIRED. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' example: title: Version retired status: 410 code: VERSION_RETIRED message: Please update the app to continue. messageKey: error_app_update_required RateLimited: description: RATE_LIMITED. headers: Retry-After: $ref: '#/components/headers/RetryAfter' content: application/problem+json: schema: $ref: '#/components/schemas/Problem' example: title: Rate limited status: 429 code: RATE_LIMITED message: Too many requests. Please try again in a minute. messageKey: error_too_many_requests InternalError: description: INTERNAL_ERROR. content: application/problem+json: schema: $ref: '#/components/schemas/Problem' example: title: Internal error status: 500 code: INTERNAL_ERROR message: Something went wrong. Please try again. messageKey: error_something_went_wrong schemas: Problem: type: object description: RFC 9457 problem details (application/problem+json). required: - title - status - code - message properties: title: type: string example: Wishlist name taken status: type: integer example: 409 code: $ref: '#/components/schemas/ErrorCode' message: type: string messageKey: type: - string - 'null' description: Key into settings widgetSettings for the shop's translated text. messageParams: type: object additionalProperties: type: string errors: type: array items: $ref: '#/components/schemas/FieldError' wishlistId: type: - integer - 'null' description: Only on SHARED_LIST_ALREADY_SAVED. ErrorCode: type: string enum: - VALIDATION_FAILED - MALFORMED_REQUEST - UNAUTHENTICATED - CUSTOMER_REQUIRED - SHARE_LOGIN_REQUIRED - API_ACCESS_NOT_IN_PLAN - GUEST_DISABLED - FEATURE_NOT_IN_PLAN - PAGE_DISABLED - PLAN_LIMIT_REACHED - WISHLIST_PRIVATE - NOT_OWNER - SHARE_LINK_TAKEN - SHARE_EMAIL_MISMATCH - ROUTE_NOT_FOUND - WISHLIST_NOT_FOUND - ITEM_NOT_FOUND - SHARE_NOT_FOUND - METHOD_NOT_ALLOWED - WISHLIST_NAME_TAKEN - ITEM_ALREADY_IN_WISHLIST - SINGLE_LIST_MODE - SHARED_LIST_ALREADY_SAVED - SHARE_REVOKED - VERSION_RETIRED - CANNOT_SAVE_OWN_WISHLIST - RATE_LIMITED - INTERNAL_ERROR - SHARE_VERIFY_FAILED FieldError: type: object properties: field: type: string message: type: string headers: RetryAfter: schema: type: integer description: Seconds until the rate-limit window resets. securitySchemes: ApiKey: type: apiKey in: header name: X-Shopify-ApiKey description: Store API key from Wishlist settings > API Settings. Shop: type: apiKey in: header name: X-Shopify-Shop description: The store's myshopify domain, e.g. your-store.myshopify.com. CustomerId: type: apiKey in: header name: X-Shopify-CustomerId description: >- Numeric Shopify customer id of a logged-in shopper. Verified against the store on every call. SessionId: type: apiKey in: header name: X-Shopify-SessionId description: Guest session id generated and persisted by the client. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.