> ## 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.

# Get Look

> Fetch a single Look by ID, including the generated hero image URL and the shoppable product cards used in the Look.



## OpenAPI

````yaml /openapi.json get /api/v1/looks/{lookId}
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/{lookId}:
    get:
      tags:
        - looks
      summary: Get Look
      description: >-
        Fetch a single Look by ID, including the generated hero image URL and
        the shoppable product cards used in the Look.
      operationId: get_v1_looks_by_lookid
      parameters:
        - name: lookId
          in: path
          required: true
          description: Look UUID.
          schema:
            type: string
      responses:
        '200':
          description: Look detail.
          content:
            application/json:
              schema:
                type: object
                required:
                  - look
                properties:
                  look:
                    type: object
                    required:
                      - id
                      - organizationId
                      - status
                      - createdAt
                      - updatedAt
                      - productCount
                      - products
                    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
                      products:
                        type: array
                        items:
                          type: object
                          required:
                            - id
                            - name
                          properties:
                            id:
                              type: string
                              description: OmniCommerce product UUID.
                            name:
                              type: string
                            sku:
                              type:
                                - string
                                - 'null'
                            brand:
                              type:
                                - string
                                - 'null'
                            price:
                              type:
                                - number
                                - 'null'
                            currency:
                              type:
                                - string
                                - 'null'
                            imageUrl:
                              type:
                                - string
                                - 'null'
                              description: Remote HTTP(S) catalog image URL.
        '401':
          description: Unauthorized - Invalid or missing Bearer token
        '403':
          description: Forbidden - Token not authorized for this organization
        '404':
          description: Look Not Found
        '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.

````