> ## Documentation Index > Fetch the complete documentation index at: https://swish.app/docs/llms.txt > Use this file to discover all available pages before exploring further. # List all shared lists > Returns all shared lists as a paginated response ## OpenAPI ````yaml https://swish.app/api/2026-07/.well-known/openapi get /shared-lists openapi: 3.0.0 info: title: Swish API description: >- The Swish API provides endpoints for managing profiles, lists, items, subscriptions, notifications, orders, etc. All endpoints require authentication using a Bearer token. Responses follow a consistent structure with a `data` wrapper for successful responses and standardized error formats. version: 2026-07 contact: {} servers: - url: https://swish.app/api/2026-07 security: [] tags: [] paths: /shared-lists: get: tags: - Shared Lists summary: List all shared lists description: Returns all shared lists as a paginated response operationId: SharedListsController_findAll parameters: - name: page required: false in: query description: The page cursor schema: type: string - name: limit required: false in: query description: Number of lists/items to return schema: default: 100 type: number responses: '200': description: Returns all shared lists as paginated response content: application/json: schema: allOf: - $ref: '#/components/schemas/PaginatedResponse' - properties: data: type: array items: $ref: '#/components/schemas/ListDetail' '400': description: Bad Request content: application/json: schema: allOf: - $ref: '#/components/schemas/ErrorResponse' - properties: error: allOf: - $ref: '#/components/schemas/Error' - properties: message: type: string example: Validation failed error: type: string example: Bad Request statusCode: type: number example: 400 requestId: type: string example: 123e4567-e89b-12d3-a456-426614174000 '401': description: Unauthorized content: application/json: schema: allOf: - $ref: '#/components/schemas/ErrorResponse' - properties: error: allOf: - $ref: '#/components/schemas/Error' - properties: message: type: string example: Failed to authenticate request error: type: string example: Unauthorized statusCode: type: number example: 401 requestId: type: string example: 123e4567-e89b-12d3-a456-426614174000 '403': description: Forbidden content: application/json: schema: allOf: - $ref: '#/components/schemas/ErrorResponse' - properties: error: allOf: - $ref: '#/components/schemas/Error' - properties: message: type: string example: >- You do not have permission to access this resource error: type: string example: Forbidden statusCode: type: number example: 403 requestId: type: string example: 123e4567-e89b-12d3-a456-426614174000 '404': description: Not Found content: application/json: schema: allOf: - $ref: '#/components/schemas/ErrorResponse' - properties: error: allOf: - $ref: '#/components/schemas/Error' - properties: message: type: string example: The requested resource was not found error: type: string example: Not Found statusCode: type: number example: 404 requestId: type: string example: 123e4567-e89b-12d3-a456-426614174000 '500': description: Internal Server Error content: application/json: schema: allOf: - $ref: '#/components/schemas/ErrorResponse' - properties: error: allOf: - $ref: '#/components/schemas/Error' - properties: message: type: string example: An unexpected error occurred error: type: string example: Internal Server Error statusCode: type: number example: 500 requestId: type: string example: 123e4567-e89b-12d3-a456-426614174000 security: - bearer: [] - Swish API key: [] components: schemas: PaginatedResponse: type: object properties: data: type: object description: Response data pageInfo: $ref: '#/components/schemas/PageInfo' required: - data - pageInfo ListDetail: type: object properties: id: type: string example: 67a61d5561e4f9de302c02a1 description: The ID of the list name: type: string example: My List description: The name of the list createdAt: type: string description: The date and time the list was created example: '2025-01-01T10:00:00.000Z' updatedAt: type: string description: The date and time the list was updated example: '2025-01-01T10:00:00.000Z' access: type: string description: The access level of the list example: private enum: - private - public type: type: string description: The type of the list example: user enum: - user - smart - shared itemCount: type: number description: The number of items in the list example: 5 previewImages: description: Array of preview image objects for the first 4 items in the list example: - id: gid://shopify/ProductImage/123456789 altText: Product image url: https://cdn.shopify.com/image1.jpg thumbhash: 1QcSHQRnh493V4dIh4eXh1h4kJUI type: array items: $ref: '#/components/schemas/PreviewImage' itemIds: description: Array of item IDs in the list example: - 67a61d5561e4f9de302c02a1 - 67a61d5561e4f9de302c02a2 type: array items: type: string required: - id - name - createdAt - updatedAt - access - itemCount - previewImages - itemIds ErrorResponse: type: object properties: error: description: Error details allOf: - $ref: '#/components/schemas/Error' required: - error Error: type: object properties: message: type: string description: The error message example: Something went wrong error: type: string description: The error type example: Not Found statusCode: type: number description: The HTTP status code of the error example: 404 requestId: type: string description: The ID of the request that caused the error example: 123e4567-e89b-12d3-a456-426614174000 required: - message - error - statusCode - requestId PageInfo: type: object properties: next: type: string description: The cursor for the next page example: YWZ0ZXI6NjdhNjFkNTU2MWU0ZjlkZTMwMmMwMmEx nullable: true previous: type: string description: The cursor for the previous page example: YmVmb3JlOjY3YTYxZDU1NjFlNGY5ZGUzMDJjMDJhMQ== nullable: true totalCount: type: number description: The total number of items across all pages example: 150 required: - next - previous - totalCount PreviewImage: type: object properties: id: type: string description: Unique identifier for the image example: gid://shopify/ProductImage/123456789 altText: type: string description: Alt text for the image example: Product image url: type: string description: URL of the image example: https://cdn.shopify.com/image1.jpg thumbhash: type: string description: Thumbhash for the image example: 1QcSHQRnh493V4dIh4eXh1h4kJUI required: - id - altText - url - thumbhash securitySchemes: Swish API key: scheme: Bearer bearerFormat: JWT type: http description: Enter your JWT token ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.