> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omnicommerce.sg/llms.txt
> Use this file to discover all available pages before exploring further.

# List Looks

> List AI-styled product Looks for the authenticated organization, newest first. Use query parameters for search, status filtering, and pagination.



## OpenAPI

````yaml /openapi.json get /api/v1/looks
openapi: 3.1.0
info:
  title: OmniCommerce API
  version: 1.0.0
  license:
    name: Proprietary
    url: https://omnicommerce.sg/terms
  description: >-
    OmniCommerce API surface for agents and developer integrations. Includes
    public endpoints (merchant discovery, product search, compare, catalog, ACO
    retrieval) and authenticated endpoints (product management via API key
    Bearer tokens).
servers:
  - url: https://omnicommerce.sg
    description: Production
  - url: http://localhost:3000
    description: Local development
security: []
tags:
  - name: agentic-checkout
    description: Merchant-fulfilled agentic checkout
    x-group: Agentic Checkout
  - name: commerce
    description: Root commerce discovery
    x-group: Commerce
  - name: developer-platform
    description: Authenticated developer platform APIs
    x-group: Developer Platform
  - name: looks
    description: AI-styled product looks
    x-group: Looks
  - name: oauth
    description: OAuth token endpoints
    x-group: OAuth
  - name: orders
    description: Workspace and agentic orders
    x-group: Orders
  - name: organizations
    description: Organization management
    x-group: Organizations
  - name: price-books
    description: Marketplace list-price markup rules
    x-group: Price Books
  - name: products
    description: Product CRUD, bulk import, and publish
    x-group: Products
  - name: promotions
    description: Central promotions and marketplace sync
    x-group: Promotions
  - name: public-agent
    description: Public agent discovery and catalog APIs
    x-group: Public Agent
  - name: settlements
    description: settlements
    x-group: Settlements
  - name: ucp
    description: Universal Commerce Protocol
    x-group: UCP
paths:
  /api/v1/looks:
    get:
      tags:
        - looks
      summary: List Looks
      description: >-
        List AI-styled product Looks for the authenticated organization, newest
        first. Use query parameters for search, status filtering, and
        pagination.
      operationId: get_v1_looks
      parameters:
        - name: q
          in: query
          required: false
          description: Search by look title, city, style, or generated prompt.
          schema:
            type: string
            maxLength: 200
        - name: status
          in: query
          required: false
          description: Filter by look status.
          schema:
            type: string
            enum:
              - draft
              - published
        - name: limit
          in: query
          required: false
          description: Result limit per page. Defaults to 24; maximum is 50.
          schema:
            type: integer
            minimum: 1
            maximum: 50
            default: 24
        - name: offset
          in: query
          required: false
          description: Zero-based pagination offset. Defaults to 0.
          schema:
            type: integer
            minimum: 0
            default: 0
      responses:
        '200':
          description: Looks page for the authenticated organization.
          content:
            application/json:
              schema:
                type: object
                required:
                  - items
                  - pagination
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      required:
                        - id
                        - organizationId
                        - status
                        - createdAt
                        - updatedAt
                        - productCount
                      properties:
                        id:
                          type: string
                          description: Look UUID.
                        organizationId:
                          type: string
                        title:
                          type:
                            - string
                            - 'null'
                        status:
                          type: string
                          enum:
                            - draft
                            - published
                        subject:
                          type:
                            - string
                            - 'null'
                        style:
                          type:
                            - string
                            - 'null'
                        season:
                          type:
                            - string
                            - 'null'
                        timeOfDay:
                          type:
                            - string
                            - 'null'
                        city:
                          type:
                            - string
                            - 'null'
                        additionalNotes:
                          type:
                            - string
                            - 'null'
                        stylePrompt:
                          type:
                            - string
                            - 'null'
                          description: One-sentence prompt used for image generation.
                        heroImageTagId:
                          type:
                            - string
                            - 'null'
                          description: >-
                            Generated image_tags UUID when image tagging
                            succeeded.
                        heroImageUrl:
                          type:
                            - string
                            - 'null'
                          description: Remote HTTP(S) URL for the generated look image.
                        createdBy:
                          type:
                            - string
                            - 'null'
                        createdAt:
                          type: string
                        updatedAt:
                          type: string
                        publishedAt:
                          type:
                            - string
                            - 'null'
                        productCount:
                          type: integer
                          minimum: 0
                  pagination:
                    type: object
                    required:
                      - offset
                      - limit
                      - total
                      - hasMore
                    properties:
                      offset:
                        type: integer
                      limit:
                        type: integer
                      total:
                        type: integer
                      hasMore:
                        type: boolean
                      nextOffset:
                        type:
                          - integer
                          - 'null'
              example:
                items:
                  - id: 11111111-1111-4111-8111-111111111111
                    organizationId: org_123
                    title: Spring city edit
                    status: draft
                    subject: model
                    style: Chic
                    season: Spring
                    timeOfDay: Day
                    city: Paris
                    heroImageUrl: https://cdn.example.com/looks/spring.png
                    productCount: 3
                    createdAt: '2026-07-04T00:00:00.000Z'
                    updatedAt: '2026-07-04T00:01:00.000Z'
                pagination:
                  offset: 0
                  limit: 24
                  total: 1
                  hasMore: false
                  nextOffset: null
        '401':
          description: Unauthorized - Invalid or missing Bearer token
        '403':
          description: Forbidden - Token not authorized for this organization
        '500':
          description: Internal Server Error
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        Bearer API key for server-to-server access. Session auth is also
        supported in first-party UI flows.

````