Returns a paginated list of wishlists for the authenticated user. The total_items count reflects the filtered results (if applied).

API ownership

• API family: Auth API
• Best for: Customer identity, session, token, cart, and wishlist flows.
• Do not use from: Merchant admin data syncs or public catalog rendering.
• Guide route: /apis/auth/latest

The OpenAPI contract defines the method, path, parameters, request body, and responses for this operation.

Operation

• Method: GET
• Path: /api/v1/\{app_id\}/wishlists
• Summary: List wishlists for authenticated user
• Description: Returns a paginated list of wishlists for the authenticated user. The total_items count reflects the filtered results (if applied).
• OpenAPI contract: auth-api
• Operation ID: Not documented in the OpenAPI contract.

Operation key uses API family, method, and path because this OpenAPI contract does not publish an operation ID.

{
  "items": [
    {
      "created_at": "string",
      "id": "string",
      "is_default": false,
      "item_count": 0,
      "name": "string",
      "updated_at": "string",
      "user_id": "string"
    }
  ],
  "page": 0,
  "page_size": 0,
  "total_items": 0,
  "total_pages": 0
}

{
  "details": [
    "string"
  ],
  "message": "string",
  "success": false
}

{
  "details": [
    "string"
  ],
  "message": "string",
  "success": false
}

{
  "details": [
    "string"
  ],
  "message": "string",
  "success": false
}

Contract identity

Use these fields to confirm you are implementing the intended endpoint contract.

• API family: Auth API
• Method: GET
• Path: /api/v1/\{app_id\}/wishlists
• Operation ID: Not documented in the OpenAPI contract.
• OpenAPI tag: Wishlist
• OpenAPI summary: List wishlists for authenticated user