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

# Get import details

> Show details of a token import



## OpenAPI

````yaml /products/commerce/v2/openapi.yaml get /tokens/imports/{id}
openapi: 3.1.0
info:
  title: Commerce API
  version: '2.0'
  description: >
    The Commerce V2 API provides a comprehensive payment orchestration platform
    designed to streamline and optimize payment processing for modern
    businesses. 

    Built with flexibility and security at its core, our API enables you to
    process payments, manage authentications, and handle cardholder data across
    multiple payment processors without vendor lock-in.
  contact:
    name: Starfish GmbH & Co. KG
    email: hello@starfish.team
    url: https://hellgate.io/cpa/commerce
  license:
    name: Commerce API Terms
    url: https://hellgate.io/terms-and-conditions
servers:
  - url: https://sandbox.hellgate.io
    description: Commerce SaaS Sandbox
  - url: https://api.hellgate.io
    description: Commerce SaaS Production
security: []
tags:
  - name: payments_ci
    description: >-
      Handle payment processing where the customer is actively present and
      authorizing the transaction.
  - name: payments_mi
    description: >-
      Process transactions without direct customer interaction at the time of
      payment.
  - name: payments_modifications
    description: >-
      Modify existing payment transactions after initial authorization (capture,
      void, refund).
  - name: payments_data
    description: >-
      Access comprehensive payment transaction data for reporting,
      reconciliation, and analysis.
  - name: refunds_data
    description: Access detailed refund transaction data for tracking and reconciliation.
  - name: authentications_ci
    description: >-
      Process EMVCo 3-D Secure authentication requests as standalone
      transactions (one-off, recurring, installment).
  - name: authentications_mi
    description: >-
      Process requestor-initiated EMVCo 3-D Secure authentication requests (3RI)
      as standalone transactions.
  - name: authentications_data
    description: Access the results of prior authentications for reference.
  - name: credentials_management
    description: >-
      Manage stored payment credentials for repeat customers across all
      operating models.
  - name: tokens_create
    description: >-
      Create and import Commerce tokens to securely store cardholder data while
      maintaining PCI DSS compliance.
  - name: tokens_management
    description: Manage stored Commerce tokens including CVC2 security code management.
  - name: compliance_service
    description: >-
      Safely handle sensitive cardholder data while maintaining PCI DSS
      compliance via a secure proxy service.
  - name: network_tokens
    description: >-
      Manage network tokens with major card schemes with automatic lifecycle
      management.
  - name: merchants
    description: >-
      Configure and manage merchant accounts based on your chosen operating
      model.
  - name: reconciliation
    description: Reconcile imported token data.
  - name: processor_backup
    description: >-
      Migrate payment tokens from third-party processors (currently supports
      stripe.com).
paths:
  /tokens/imports/{id}:
    get:
      tags:
        - processor_backup
      summary: Get import details
      description: Show details of a token import
      operationId: get_tokens_details
      parameters:
        - in: path
          name: id
          description: The ID of the import.
          schema:
            type: string
            format: uuid
          required: true
      responses:
        '200':
          description: Success response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TokensImport'
              examples:
                Preparing:
                  $ref: '#/components/examples/import_preparing'
                Running:
                  $ref: '#/components/examples/import_running'
                Finished:
                  $ref: '#/components/examples/import_finished'
        '401':
          $ref: '#/components/responses/401_UnauthorizedError'
        '403':
          $ref: '#/components/responses/403_ForbiddenError'
        '422':
          $ref: '#/components/responses/422_ValidationError'
      security:
        - APIKeyAuth: []
components:
  schemas:
    TokensImport:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: The ID of the import.
        created_at:
          type: string
          description: The timestamp when the import was requested.
          format: date-time
        finished_at:
          type: string
          description: >
            The timestamp when the import was finished. 


            It is only available if the import was successfully finished or was
            aborted.
          format: date-time
        provider:
          type: string
          enum:
            - stripe
        status:
          type: string
          enum:
            - preparing
            - running
            - finished
            - aborted
          example: preparing
        stripe:
          type: object
          properties:
            api_key:
              type: string
              description: The redacted key which was sent when requesting the import.
              example: '[REDACTED]'
        attemts:
          type: integer
          description: The amount of attempts to import a token.
        successes:
          type: integer
          description: The amount of successful imports.
        failures:
          type: integer
          description: The amount of failures while importing a token.
    ErrorGeneric:
      type: object
      properties:
        code:
          $ref: '#/components/schemas/ErrorStatusCode'
        classifier:
          $ref: '#/components/schemas/ErrorClassifier'
        message:
          $ref: '#/components/schemas/ErrorMessage'
    ErrorValidation:
      type: object
      properties:
        code:
          $ref: '#/components/schemas/ErrorStatusCode'
        classifier:
          $ref: '#/components/schemas/ErrorClassifier'
        message:
          $ref: '#/components/schemas/ErrorMessage'
        validation_errors:
          type: array
          items:
            type: object
            properties:
              path:
                type: string
                description: Json-path in the request which points to the validation error
              message:
                type: string
                description: Human readable validation message
    ErrorStatusCode:
      type: integer
      description: The corresponding HTTP status code for the error
    ErrorClassifier:
      type: string
      description: Technical code that helps to identify the error
    ErrorMessage:
      type: string
      description: Human readable representation of the error
  examples:
    import_preparing:
      value:
        id: 63820065-af1a-42fa-b96f-8d928fc6c2ec
        created_at: '2023-10-10T00:00:00Z'
        provider: stripe
        status: preparing
        stripe:
          api_key: '[REDACTED]'
        attemts: 0
        successes: 0
        failures: 0
    import_running:
      value:
        id: 63820065-af1a-42fa-b96f-8d928fc6c2ec
        created_at: '2023-10-10T00:00:00Z'
        provider: stripe
        status: running
        stripe:
          api_key: '[REDACTED]'
        attemts: 100
        successes: 99
        failures: 1
    import_finished:
      value:
        id: 63820065-af1a-42fa-b96f-8d928fc6c2ec
        created_at: '2023-10-10T00:00:00Z'
        finished_at: '2023-10-10T01:00:00Z'
        provider: stripe
        status: finished
        stripe:
          api_key: '[REDACTED]'
        attemts: 200
        successes: 199
        failures: 1
  responses:
    401_UnauthorizedError:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorGeneric'
          example:
            code: 401
            message: No valid means of authentication was provided
            classifier: UNAUTHORIZED
    403_ForbiddenError:
      description: Forbidden
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorGeneric'
          example:
            code: 403
            message: Not allowed to access this resource or feature
            classifier: FORBIDDEN
    422_ValidationError:
      description: Validation error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorValidation'
          example:
            code: 422
            classifier: VALIDATION_ERROR
            message: Validation error
            validation_errors:
              - path: json-path
                message: human readable error message
  securitySchemes:
    APIKeyAuth:
      type: apiKey
      name: X-API-Key
      in: header

````