> ## 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 Selected Zalora Import Status

> Requires catalog:read. Follow the unchanged links.job URL returned by POST. Reads current state once without waiting.

### Completion

data.status is pending, running, success, or error; data.terminal and data.success identify completion. data.productIds contains mapped Omni IDs for the supplied product sets. Failed imports remain explicit, including missingExternalIds. The top-level completed status describes this status request, not the import.

Keep the original target IDs: the status lookup resolves those targets and does not prove that a modified selection was part of this job.



## OpenAPI

````yaml /openapi.json get /api/v1/zalora/import
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: aops
    description: Agent operating procedures
    x-group: AOPs
  - 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/zalora/import:
    get:
      tags:
        - developer-platform
      summary: Get Selected Zalora Import Status
      description: >-
        Requires catalog:read. Follow the unchanged links.job URL returned by
        POST. Reads current state once without waiting.


        ### Completion


        data.status is pending, running, success, or error; data.terminal and
        data.success identify completion. data.productIds contains mapped Omni
        IDs for the supplied product sets. Failed imports remain explicit,
        including missingExternalIds. The top-level completed status describes
        this status request, not the import.


        Keep the original target IDs: the status lookup resolves those targets
        and does not prove that a modified selection was part of this job.
      operationId: get_v1_zalora_import
      parameters:
        - name: organizationId
          in: query
          required: false
          schema:
            $schema: https://json-schema.org/draft/2020-12/schema
            description: >-
              Required for session auth; derived from the credential for bearer
              auth.
            type: string
            minLength: 1
            maxLength: 255
        - name: jobId
          in: query
          required: true
          schema:
            $schema: https://json-schema.org/draft/2020-12/schema
            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)$
        - name: storeId
          in: query
          required: true
          schema:
            $schema: https://json-schema.org/draft/2020-12/schema
            type: string
            minLength: 1
            maxLength: 255
        - name: productSetIds
          in: query
          required: true
          style: form
          explode: true
          schema:
            $schema: https://json-schema.org/draft/2020-12/schema
            minItems: 1
            maxItems: 25
            type: array
            items:
              type: string
              minLength: 1
              maxLength: 255
            description: >-
              Zalora productSetIds to import. Values are trimmed and
              de-duplicated while preserving order.
      responses:
        '200':
          description: Current import state; inspect data.terminal and data.success.
          content:
            application/json:
              schema:
                type: object
                required:
                  - ok
                  - status
                  - jobId
                  - data
                  - links
                properties:
                  ok:
                    type: boolean
                  apiVersion:
                    type: string
                  operationId:
                    type: string
                  status:
                    type: string
                    enum:
                      - completed
                  jobId:
                    type: string
                  links:
                    type: object
                    additionalProperties:
                      type: string
                  warnings:
                    type: array
                    items:
                      type: string
                  recommendations:
                    type: array
                    items:
                      type: string
                  data:
                    type: object
                    required:
                      - id
                      - status
                      - terminal
                      - success
                      - productIds
                    properties:
                      id:
                        type: string
                      kind:
                        type: string
                        enum:
                          - zalora_import
                      status:
                        type: string
                        enum:
                          - pending
                          - running
                          - success
                          - error
                      terminal:
                        type: boolean
                      success:
                        type: boolean
                      productIds:
                        type: array
                        items:
                          type: string
                      externalIds:
                        type: array
                        items:
                          type: string
                      missingExternalIds:
                        type: array
                        items:
                          type: string
                      storeId:
                        type: string
                      error:
                        type: string
                      message:
                        type: string
        '400':
          description: >-
            Invalid request or queue preparation failed. Inspect the error
            before resubmitting.
        '401':
          description: Missing or invalid credentials.
        '403':
          description: >-
            Missing scope, insufficient permission, organization mismatch, or
            inactive organization.
        '404':
          description: Target not found in the authenticated organization.
        '409':
          description: An import or enrichment job is already active for the target.
        '429':
          description: Rate limit exceeded.
      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.

````