> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vortexiq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get migration issues

> The per-item issue log in three lists: items that **failed**, items intentionally **skipped** with the reason why, and non-blocking **warnings** (things the engine worked around without failing the run).

Use this to answer "which products didn't make it, and why?". The log is embedded into the durable snapshot before a run's working files are reclaimed, so it stays readable for finished runs. Entries are sanitised — entity, name, status, and reason only; never request bodies or credentials.



## OpenAPI

````yaml vortex-apps/staging-pro/api/openapi.json GET /migrations/{id}/issues
openapi: 3.1.0
info:
  title: StagingPro V2 Migration API (BigCommerce)
  version: 2.0.0
  description: >-
    REST API for the StagingPro V2 BC Migration app. Browse a connected store's
    catalogue, size a migration before you run it, launch bulk or selective
    store-to-store migrations, control runs, and follow live progress.


    All endpoints are served from `https://app.vortexiq.ai/v2/api/bc-migration`
    and are scoped to your organisation. Authenticate with a bearer token from
    the Login endpoint (scripts and services) or your signed-in session
    (browser). See
    [Authentication](/vortex-apps/staging-pro/api/authentication).
  contact:
    name: Vortex IQ Support
    url: https://www.vortexiq.ai/contact-us
servers:
  - url: https://app.vortexiq.ai/v2/api/bc-migration
    description: Vortex IQ platform (production)
security:
  - bearerAuth: []
tags:
  - name: Authentication
    description: >-
      Exchange your identity and your organisation's API credential for a bearer
      token.
  - name: Migrations
    description: >-
      Create migrations, list history, read run detail and per-item issues, and
      follow live progress.
  - name: Migration Controls
    description: Pause, resume, cancel, and verify-only re-runs.
  - name: Counts & Forecast
    description: Size a migration before launching it. Neither endpoint creates a run.
paths:
  /migrations/{id}/issues:
    get:
      tags:
        - Migrations
      summary: Get migration issues
      description: >-
        The per-item issue log in three lists: items that **failed**, items
        intentionally **skipped** with the reason why, and non-blocking
        **warnings** (things the engine worked around without failing the run).


        Use this to answer "which products didn't make it, and why?". The log is
        embedded into the durable snapshot before a run's working files are
        reclaimed, so it stays readable for finished runs. Entries are sanitised
        — entity, name, status, and reason only; never request bodies or
        credentials.
      operationId: getMigrationIssues
      parameters:
        - $ref: '#/components/parameters/MigrationId'
      responses:
        '200':
          description: Failures, skipped items, and warnings.
          headers:
            X-Read-Source:
              description: >-
                Which store served this read: `opensearch`, `mysql`, or
                `engine`. Observability only.
              schema:
                type: string
                enum:
                  - opensearch
                  - mysql
                  - engine
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IssuesResponse'
              example:
                failures:
                  - entity: products
                    name: Smith Journal 13
                    status: 422
                    reason: duplicate SKU SM-13 on destination
                skipped:
                  - entity: pages
                    name: Legacy landing
                    status: null
                    reason: page type not supported by destination theme
                warnings:
                  - entity: images
                    name: '#101'
                    reason: source image returned 404 — product migrated without it
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  parameters:
    MigrationId:
      name: id
      in: path
      required: true
      schema:
        type: string
      description: The migration request id returned by Create migration.
      example: 5A3C1B2E-7F4D-4E6A-9B8C-0D1E2F3A4B5C
  schemas:
    IssuesResponse:
      type: object
      properties:
        failures:
          type: array
          items:
            $ref: '#/components/schemas/IssueItem'
        skipped:
          type: array
          items:
            $ref: '#/components/schemas/IssueItem'
        warnings:
          type: array
          items:
            $ref: '#/components/schemas/WarningItem'
          description: >-
            Non-blocking issues (for example an unrecoverable 404 source image,
            or a dropped filter context). They do not fail the run.
    IssueItem:
      type: object
      properties:
        entity:
          type: string
          description: Which entity type the item belongs to.
        name:
          type: string
          description: Item name, code, or `#<source-id>`.
        status:
          type:
            - integer
            - 'null'
          description: HTTP status of the failing call, when applicable.
        reason:
          type: string
          description: Why it failed, or why it was intentionally skipped.
    WarningItem:
      type: object
      properties:
        entity:
          type: string
        name:
          type: string
          description: Item name, `channel <id>`, or `#<product-id>` depending on context.
        reason:
          type: string
          description: What was skipped or altered, and why.
    Error:
      type: object
      properties:
        error:
          type: string
          description: Machine-readable error code.
        message:
          type: string
          description: Human-readable explanation.
        status:
          type: integer
          description: 'Present on `bc_error`: the status BigCommerce returned.'
        errors:
          type: object
          additionalProperties: true
          description: 'Present on validation failures: field-level messages.'
  responses:
    Forbidden:
      description: >-
        Store Migration is not enabled for your organisation. Requests with no
        valid bearer token or session return `401` instead.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            message: Store Migration is not enabled for this organization.
    NotFound:
      description: No such migration in your organisation.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        A bearer token from [Login](/vortex-apps/staging-pro/api/login), sent as
        `Authorization: Bearer <token>`. Valid for 10 days; scoped to the user
        and organisation it was issued for. Rotating or disabling the
        organisation's API credential immediately invalidates all outstanding
        tokens. Browser calls from a signed-in app.vortexiq.ai page are also
        accepted via session cookie — see
        [Authentication](/vortex-apps/staging-pro/api/authentication).

````