> ## Documentation Index > Fetch the complete documentation index at: https://docs.omnicommerce.ai/llms.txt > Use this file to discover all available pages before exploring further. # Start Commerce Verification > Queue durable fresh verification for up to 2000 products in the existing verification contract, under verification. Requires catalog:read. Returns immediately with operationIds. Read bulk.status and bulk.results; a client timeout does not discard work. Fulfillment correlations continue to use commerce.verifyState. ## OpenAPI ````yaml /openapi.json post /api/v1/commerce/state/verify/jobs 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.ai 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: branding description: branding x-group: Branding - name: campaigns description: Campaign briefs, offer windows, and marketplace runs x-group: Campaigns - name: catalog description: catalog x-group: Catalog - name: commerce description: commerce x-group: Commerce - name: developer-platform description: Authenticated developer platform APIs x-group: Developer Platform - name: documents description: Knowledge base document uploads x-group: Knowledge Base - name: inventory description: Inventory quantities, planning signals, and marketplace listing absence x-group: Inventory - 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: scripts description: scripts x-group: Scripts - name: settlements description: settlements x-group: Settlements - name: ucp description: Universal Commerce Protocol x-group: UCP paths: /api/v1/commerce/state/verify/jobs: post: tags: - catalog summary: Start Commerce Verification description: >- Queue durable fresh verification for up to 2000 products in the existing verification contract, under verification. Requires catalog:read. Returns immediately with operationIds. Read bulk.status and bulk.results; a client timeout does not discard work. Fulfillment correlations continue to use commerce.verifyState. operationId: post_v1_commerce_state_verify_jobs requestBody: required: true content: application/json: schema: type: object properties: organizationId: type: string minLength: 1 idempotencyKey: type: string minLength: 1 maxLength: 128 verification: type: object properties: correlations: description: >- Durable product verification does not accept job correlations; use commerce.verifyState for those. minItems: 1 maxItems: 0 type: array items: type: object properties: kind: type: string enum: - order_action - return_action - price_book_sync id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ platform: type: string minLength: 1 storeId: type: string minLength: 1 productId: type: string minLength: 1 productIds: maxItems: 500 type: array items: type: string minLength: 1 externalIds: maxItems: 500 type: array items: type: string minLength: 1 required: - kind - id productIds: description: Up to 2000 existing product or variant IDs. minItems: 1 maxItems: 2000 type: array items: type: string minLength: 1 expected: description: >- Expected commerce state after a write (price, quantity, listingStatus, etc). type: object properties: price: type: number salePrice: anyOf: - type: number - type: 'null' currency: type: string pattern: ^[A-Za-z]{3}$ quantity: type: integer minimum: 0 maximum: 9007199254740991 listingStatus: type: string enum: - active - draft - unlisted - deleted platforms: type: array items: type: string minLength: 1 targets: description: >- Up to 2000 product targets with distinct expected states. Identical duplicates collapse; conflicting expectations fail. minItems: 1 maxItems: 2000 type: array items: type: object properties: productId: type: string minLength: 1 maxLength: 255 expected: type: object properties: price: type: number salePrice: anyOf: - type: number - type: 'null' currency: type: string pattern: ^[A-Za-z]{3}$ quantity: type: integer minimum: 0 maximum: 9007199254740991 listingStatus: type: string enum: - active - draft - unlisted - deleted platforms: type: array items: type: string minLength: 1 required: - productId - expected additionalProperties: false action: description: >- Lifecycle action being verified. Use delete for Omni-only delete checks. type: string enum: - price - inventory - publish - update - delist - delete platforms: description: >- Optional marketplace filter: shopee, lazada, tiktok, shopify, whatsapp, zalora, amazon, ebay. type: array items: type: string minLength: 1 includeOmni: description: Also assert Omni DB fields (default true). type: boolean additionalProperties: false sessionId: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ required: - idempotencyKey - verification additionalProperties: false responses: '202': description: >- Durable operation accepted; completion and verification remain pending. content: application/json: schema: type: object required: - ok - data properties: ok: type: boolean apiVersion: type: string operationId: type: string status: type: string data: type: object properties: queued: type: boolean operationIds: type: array items: type: string productIds: type: array items: type: string operation: type: object properties: operationId: type: string kind: type: string enum: - update - verify success: type: boolean allTerminal: type: boolean status: type: string totalCount: type: number succeededCount: type: number failedCount: type: number pendingCount: type: number syncingCount: type: number verifiedCount: type: number verificationRequested: type: boolean phases: type: object propertyNames: type: string additionalProperties: type: number updatedAt: type: string completedAt: anyOf: - type: string - type: 'null' error: type: string report: type: string required: - operationId - success - allTerminal - status required: - queued - operationIds - productIds - operation '400': description: Invalid request. '401': description: Authentication required. '403': description: Missing capability or organization/product access. '409': description: Idempotency key reused with different input. '503': description: Temporarily unavailable. Retry the same idempotency key. 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.