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

# Export Catalog Items

> Cursor-page the authenticated organization's product and variant catalog for pricing systems. Requires `catalog:read`.

Each item includes product-family identity, SKU/UPC, cost, current, sale, compare-at, MAP, and MSRP prices, inventory, active promotion context, and exact marketplace identifiers. Set `format=csv` for a Spresso-compatible catalog intake shape.



## OpenAPI

````yaml /openapi.json get /api/v1/catalog/items
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: returns
    description: returns
    x-group: Returns
  - name: settlements
    description: settlements
    x-group: Settlements
  - name: ucp
    description: Universal Commerce Protocol
    x-group: UCP
paths:
  /api/v1/catalog/items:
    get:
      tags:
        - products
      summary: Export Catalog Items
      description: >-
        Cursor-page the authenticated organization's product and variant catalog
        for pricing systems. Requires `catalog:read`.


        Each item includes product-family identity, SKU/UPC, cost, current,
        sale, compare-at, MAP, and MSRP prices, inventory, active promotion
        context, and exact marketplace identifiers. Set `format=csv` for a
        Spresso-compatible catalog intake shape.
      operationId: get_v1_catalog_items
      parameters:
        - name: organizationId
          in: query
          required: false
          description: >-
            Optional organization scope for session-authenticated calls. OAuth
            client credentials resolve the organization from the token.
          schema:
            type: string
            maxLength: 120
        - name: updatedSince
          in: query
          required: false
          description: Inclusive item update lower bound for incremental exports.
          schema:
            type: string
            format: date-time
        - name: cursor
          in: query
          required: false
          schema:
            type: string
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 500
            default: 100
        - name: format
          in: query
          required: false
          description: Use csv for the documented Spresso catalog columns; omit for JSON.
          schema:
            type: string
            enum:
              - json
              - csv
            default: json
      responses:
        '200':
          description: >-
            Catalog page as JSON, or CSV with X-Has-More and X-Next-Cursor
            headers.
        '400':
          description: Invalid cursor or updatedSince value.
        '401':
          description: Unauthorized.
        '403':
          description: Missing catalog:read scope.
        '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.

````