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

# Inspect an import file

> Starts a look at an uploaded import file: its worksheets, its header, its first rows and how many rows it has.



## OpenAPI

````yaml /openapi/en.json post /api/v1/orgs/{orgId}/core/imports/inspect
openapi: 3.1.0
info:
  title: Ready for Commerce API
  version: 1.0.0
  description: >-
    The reference of every operation of the Ready for Commerce API. Every
    operation is in beta until launch.
servers:
  - url: https://app.readyforcommerce.com
security:
  - apiKey: []
tags:
  - name: Credentials
    description: >-
      The credential that calls: its organization, its permissions, its limits
      and the calls it may still make.
  - name: Organization
    description: 'The organization''s settings: its name, slug and currency.'
  - name: Billing
    description: >-
      The organization's subscription and each module's bill and cap, and this
      month's usage against its free allowance.
  - name: Record types
    description: >-
      The kinds of record the credential may import or export, with each one's
      fields and options.
  - name: Imports
    description: >-
      Bring CSV or Excel files in: upload or fetch a file, inspect and check it,
      then start the import and read its results.
  - name: Files
    description: An uploaded file's status, until it is ready or rejected.
  - name: Exports
    description: Export the records a filter matches to CSV or Excel files, kept 14 days.
  - name: Export templates
    description: Saved export setups, by name, to run the same export again.
  - name: Jobs
    description: >-
      Long work runs as a job: follow its state and progress, read its messages,
      download its files or cancel it.
  - name: Search
    description: >-
      Find the organization's records by words, a typo included, grouped by
      kind.
  - name: Version history
    description: >-
      A record's versions, newest first: compare one with another and restore
      the record to it.
  - name: Incidents
    description: >-
      The organization's problems you may see: mark them read or unread, and
      resolve them.
  - name: Notifications
    description: >-
      Your notifications, newest first: mark one read or unread, or all of them
      read.
  - name: Saved views
    description: >-
      A table's search, filters, order and columns saved under a name, yours or
      shared with the organization, and the view each table opens with for you.
  - name: Store connections
    description: >-
      The organization's stores, connected with their pasted keys: list them,
      connect one, reconnect it with new keys or disconnect it.
  - name: Products
    description: >-
      The organization's products with their options, variants and prices: list
      them, read one, create one, change one's content, its prices or its
      status, duplicate one as a draft, or delete one.
paths:
  /api/v1/orgs/{orgId}/core/imports/inspect:
    post:
      tags:
        - Imports
      summary: Inspect an import file
      description: >-
        Starts a look at an uploaded import file: its worksheets, its header,
        its first rows and how many rows it has.
      operationId: coreInspectImport
      parameters:
        - schema:
            type: string
            format: uuid
          in: path
          name: orgId
          required: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InspectImportInput'
      responses:
        '202':
          description: 'Accepted: the job started. Follow it by its `jobId`.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImportStarted'
        default:
          description: >-
            An error, as `application/problem+json`: its `code` says what went
            wrong and `params` holds its values
          content:
            application/problem+json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/Problem'
                  - properties:
                      code:
                        enum:
                          - core.dataio_adapter_not_found
                          - core.file_not_found
                          - core.idempotency_in_progress
                          - core.idempotency_mismatch
                          - core.job_limit_reached
                          - core.bad_request
                          - core.invalid_credential
                          - core.forbidden
                          - core.module_not_enabled
                          - core.module_read_only
                          - core.not_found
                          - core.conflict
                          - core.org_deletion_scheduled
                          - core.payload_too_large
                          - core.unsupported_media_type
                          - core.validation_failed
                          - core.rate_limited
                          - core.surface_disabled
                          - core.internal
                          - core.unavailable
components:
  schemas:
    InspectImportInput:
      type: object
      properties:
        entity:
          type: string
        fileId:
          type: string
          format: uuid
        worksheet:
          type: string
          minLength: 1
        hasHeader:
          type: boolean
      required:
        - entity
        - fileId
    ImportStarted:
      type: object
      properties:
        jobId:
          type: string
          format: uuid
      required:
        - jobId
      additionalProperties: false
    Problem:
      type: object
      properties:
        type:
          type: string
          pattern: ^urn:rfc:problem:[\s\S]{0,}\.[\s\S]{0,}$
        status:
          type: integer
        title:
          type: string
        code:
          type: string
          pattern: ^[\s\S]{0,}\.[\s\S]{0,}$
        params:
          type: object
          propertyNames:
            type: string
          additionalProperties: {}
        requestId:
          type: string
        errors:
          type: array
          items:
            type: object
            properties:
              location:
                type: string
              pointer:
                type: string
              code:
                type: string
              params:
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
            required:
              - location
              - pointer
              - code
            additionalProperties: false
      required:
        - type
        - status
        - code
        - requestId
      additionalProperties: false
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: >-
        An organization's API key, sent on every call as `Authorization: Bearer
        <key>`. A person of the organization creates it in the app, in
        **Settings › API and connections › API keys**.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.