> ## 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 Product Listings > Where a product is listed: each marketplace's store, live or delisted state, item id, buyer-facing URL, and the latest publish attempt with any rejection details. Requires `catalog:read`. Poll after `POST /api/v1/products/{productId}/publish`. ## OpenAPI ````yaml /openapi.json get /api/v1/products/{productId}/listings 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: agents description: agents x-group: Agents - name: analytics description: Sales performance across marketplaces x-group: Analytics - name: aops description: Agent operating procedures x-group: AOPs - name: campaigns description: Campaign briefs, offer windows, and marketplace runs x-group: Campaigns - 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, enrichment, publish, and delist 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: reviews description: Marketplace product reviews and seller replies x-group: Reviews - name: settlements description: settlements x-group: Settlements - name: ucp description: Universal Commerce Protocol x-group: UCP paths: /api/v1/products/{productId}/listings: get: tags: - products summary: Get Product Listings description: >- Where a product is listed: each marketplace's store, live or delisted state, item id, buyer-facing URL, and the latest publish attempt with any rejection details. Requires `catalog:read`. Poll after `POST /api/v1/products/{productId}/publish`. operationId: get_v1_products_by_productid_listings parameters: - name: productId in: path required: true schema: type: string - name: organizationId in: query required: false description: >- Required for session auth. API keys already belong to one organization. schema: type: string maxLength: 160 responses: '200': description: The product's listings. content: application/json: schema: type: object properties: ok: type: boolean apiVersion: type: string const: developer_v1 operationId: type: string status: type: string enum: - accepted - completed - failed jobId: type: string productId: type: string warnings: type: array items: type: string recommendations: type: array items: type: string links: type: object propertyNames: type: string additionalProperties: type: string data: type: object properties: productId: type: string listings: type: array items: type: object properties: marketplace: type: string marketplaceLabel: type: string country: anyOf: - type: string - type: 'null' storeId: anyOf: - type: string - type: 'null' storeLabel: anyOf: - type: string - type: 'null' published: type: boolean description: >- The marketplace has a live listing for the product. unlisted: type: boolean description: >- The listing was delisted; its marketplace identity is kept. itemId: anyOf: - type: string - type: 'null' description: Marketplace item id. listingUrl: anyOf: - type: string - type: 'null' description: Buyer-facing listing URL while published. publishedAt: anyOf: - type: string - type: 'null' latestPublish: anyOf: - type: object properties: jobId: type: string status: type: string enum: - pending - running - success - error action: anyOf: - type: string - type: 'null' description: >- `created` or `updated` once the job has run. message: anyOf: - type: string - type: 'null' error: anyOf: - type: string - type: 'null' errorDetail: description: >- The marketplace's rejection details, when it returned any. updatedAt: type: string required: - jobId - status - action - message - error - updatedAt - type: 'null' description: >- The most recent publish to this marketplace, including one still running. required: - marketplace - marketplaceLabel - country - storeId - storeLabel - published - unlisted - itemId - listingUrl - publishedAt - latestPublish required: - productId - listings required: - ok - apiVersion - operationId - status - warnings - recommendations - links - data '400': description: Invalid request '401': description: Unauthorized '403': description: Missing the `catalog:read` scope '404': description: Product not found '429': description: Rate limit exceeded '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. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.