> ## 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 > Retrieve a single product by ID for the authenticated organization. Supports API key Bearer token authentication. The response includes generated Agentic Commerce Optimization (ACO) profile metadata, FAQs, localization content, intent queries, cultural notes, signals, sources, and claims when present. ## OpenAPI ````yaml /openapi.json get /api/v1/products/{productId} 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/products/{productId}: get: tags: - products summary: Get Product description: >- Retrieve a single product by ID for the authenticated organization. Supports API key Bearer token authentication. The response includes generated Agentic Commerce Optimization (ACO) profile metadata, FAQs, localization content, intent queries, cultural notes, signals, sources, and claims when present. operationId: get_v1_products_by_productid parameters: - name: productId in: path required: true schema: type: string responses: '200': description: Success content: application/json: schema: type: object properties: id: type: string parentId: type: - string - 'null' name: type: string description: type: string sku: type: string brand: type: - string - 'null' price: type: - number - 'null' currency: type: string status: type: string images: type: array items: type: object highlights: type: - array - 'null' items: type: string marketplaces: type: object inventory: type: object weight: type: - number - 'null' dimensions: type: - object - 'null' seoTitle: type: - string - 'null' seoDescription: type: - string - 'null' tags: type: - array - 'null' items: type: string bundle: type: - object - 'null' acoProfile: type: - object - 'null' description: >- Current ACO/GEO profile metadata for the product. Null when no profile has been generated. properties: profileId: type: string productId: type: string readinessScore: type: - number - 'null' intentSummary: type: string generatedAt: type: - string - 'null' description: ISO 8601 timestamp updatedAt: type: - string - 'null' description: ISO 8601 timestamp platformScope: type: array items: type: string countryScope: type: array description: Country hints associated with the current ACO profile. items: type: string generationVersion: type: - string - 'null' scoringVersion: type: - string - 'null' localizationVersion: type: - string - 'null' promptVersion: type: - string - 'null' ontologyVersion: type: - string - 'null' warnings: type: array items: type: string seasonalRelevance: type: object compliance: type: object trust: type: object categoryAttributes: type: object acoFaqs: type: array description: >- Generated Agentic Commerce Optimization FAQs for the product, ordered by language then rank. Empty array when no ACO profile has been generated yet. items: type: object properties: question: type: string answer: type: string language: type: - string - 'null' description: ISO 639-1 language code (en, th, id, ms, vi, tl). intentKey: type: - string - 'null' description: >- Intent ontology key (e.g., capable_of, suitable_for_context, used_for_audience, compliance_flag). rank: type: - integer - 'null' description: >- Rank within the language group. Lower is more prominent. confidence: type: - number - 'null' description: Generator confidence, 0..1. evidenceKeys: type: array items: type: string citationUrls: type: array items: type: string required: - question - answer acoLocalizations: type: array description: >- Localized ACO content by language, including intent descriptions, generated buyer intent queries, and cultural notes. items: type: object properties: profileId: type: string language: type: string intentDescription: type: string intentQueries: type: array items: type: string countries: type: array description: >- Country hints this localization and cultural note applies to. items: type: string culturalNotes: type: object required: - language - intentDescription acoSignals: type: array description: >- Normalized ACO retrieval and ranking signals extracted from the product profile. items: type: object properties: profileId: type: string key: type: string display: type: string normalized: type: string country: type: - string - 'null' language: type: - string - 'null' source: type: string attributeClass: type: - string - 'null' acoIntentQueries: type: array description: >- Deduplicated buyer intent queries aggregated from all ACO localizations. items: type: string acoCulturalNotes: type: object description: >- Cultural notes keyed by `language:country` (example: `en:sg`). Uses `global` when no country scope is known. additionalProperties: type: object properties: language: type: string country: type: string notes: type: object required: - language - country - notes acoSources: type: array description: Citation/source records used by ACO trust enrichment. items: type: object properties: url: type: string label: type: - string - 'null' metadata: type: object createdAt: type: - string - 'null' acoClaims: type: array description: >- Trust claims and citation URLs associated with the generated ACO profile. items: type: object properties: fieldPath: type: string text: type: string isFactual: type: boolean status: type: - string - 'null' citationUrls: type: array items: type: string createdAt: type: string description: ISO 8601 timestamp updatedAt: type: string description: ISO 8601 timestamp '401': description: Unauthorized - Invalid or missing Bearer token '403': description: Forbidden - Token not authorized for this organization '404': description: Product 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. ````