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

# Get an import job

> Progress and result of an import.

**Scope:** `import:read`



## OpenAPI

````yaml GET /api/merchant/v1/stores/{storeId}/import/jobs/{jobId}
openapi: 3.1.0
info:
  title: Join Markt Merchant API
  version: 1.0.0
  description: >-
    Manage your Join Markt store from your own code: products, orders,
    customers, coupons, themes and more.


    Create an API key in **Dashboard → Developers → API keys**, then send it as
    `Authorization: Bearer mk_live_…`. Each key only works on the stores and
    scopes you chose for it.


    Limits: 120 requests per minute per key. Every response is JSON.
  contact:
    name: Join Markt Support
    url: https://joinmarkt.com/contact
servers:
  - url: https://dash.joinmarkt.com
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Store
    description: Store profile and settings.
  - name: Products
    description: Create, update and delete products, and manage license-key stock.
  - name: Categories
    description: Group products into categories.
  - name: Groups
    description: Bundle several products under one storefront card.
  - name: Orders
    description: Read orders, add notes and mark manual deliveries done.
  - name: Invoices
    description: Read invoices issued for orders.
  - name: Customers
    description: Read customers and adjust their store balance.
  - name: Coupons
    description: Create and manage discount codes.
  - name: Reviews
    description: Read buyer reviews and reply to them.
  - name: Tickets
    description: Support tickets from buyers.
  - name: Analytics
    description: Revenue and traffic numbers.
  - name: Balance & payouts
    description: Seller balance and payout requests.
  - name: Payments
    description: Payment method settings. Secrets are never returned.
  - name: Storefront
    description: Storefront appearance and integrations.
  - name: Themes
    description: Apply catalog themes and edit theme projects.
  - name: Domain
    description: Connect a custom domain.
  - name: Security
    description: Blacklist and anti-fraud settings.
  - name: Notifications
    description: Recent store notifications.
  - name: Discord
    description: Discord bot settings.
  - name: Import
    description: Import products and customers from another platform.
  - name: Webhooks
    description: Get events sent to your own server.
paths:
  /api/merchant/v1/stores/{storeId}/import/jobs/{jobId}:
    get:
      tags:
        - Import
      summary: Get an import job
      description: |-
        Progress and result of an import.

        **Scope:** `import:read`
      operationId: getImportJobsByJobId
      parameters:
        - $ref: '#/components/parameters/storeId'
        - in: path
          name: jobId
          description: Import job id.
          schema:
            type: string
          required: true
      responses:
        '200':
          description: The job.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
      x-codeSamples:
        - lang: bash
          label: cURL
          source: >-
            curl -X GET
            "https://dash.joinmarkt.com/api/merchant/v1/stores/STORE_ID/import/jobs/{jobId}"
            \
              -H "Authorization: Bearer $JOIN_MARKT_API_KEY"
        - lang: javascript
          label: JavaScript
          source: >-
            const res = await
            fetch("https://dash.joinmarkt.com/api/merchant/v1/stores/STORE_ID/import/jobs/{jobId}",
            {
              method: "GET",
              headers: {
                Authorization: `Bearer ${process.env.JOIN_MARKT_API_KEY}`,
              },
            })

            const data = await res.json()
        - lang: python
          label: Python
          source: |-
            import os, requests

            res = requests.get(
                "https://dash.joinmarkt.com/api/merchant/v1/stores/STORE_ID/import/jobs/{jobId}",
                headers={"Authorization": f"Bearer {os.environ['JOIN_MARKT_API_KEY']}"},
            )
            data = res.json()
components:
  parameters:
    storeId:
      name: storeId
      in: path
      required: true
      description: >-
        Your store id. Find it in Dashboard → Developers, or in `GET /stores`
        with MCP.
      schema:
        type: string
  responses:
    BadRequest:
      description: The request body or a parameter is not valid. `error` names the field.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: The API key is missing, wrong, expired or revoked.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: The key is valid but has no access to this store, or lacks the scope.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: Nothing with this id exists in this store.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    RateLimited:
      description: More than 120 requests in a minute. Wait and try again.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: What went wrong, in plain words.
          examples:
            - Product not found
        code:
          type: string
          description: Stable error code.
          examples:
            - NOT_FOUND
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: mk_live_…
      description: Your Merchant API key. Create one in Dashboard → Developers → API keys.

````

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