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

# Get custom connection import result

> Request a custom connection import result by connection ID and import ID.



## OpenAPI

````yaml api-reference/platform-api.json get /v2/account-connections/{id}/imports/{importId}
openapi: 3.0.0
info:
  title: Range Platform API
  description: >-
    The Range Platform API for workspace management, counterparties, and
    operational tooling.
  version: 1.7.37
  contact: {}
servers:
  - url: https://api.range.org
    description: Range API Server
security:
  - Authorization: []
  - Authorization: []
tags:
  - name: Address Information
    description: Get information about a crypto address.
  - name: Transfer Enrichments
    description: Attach workspace-scoped notes and categories to transfers.
  - name: Counterparties
    description: Manage external entities, their addresses, bank accounts, and documents.
  - name: Parties
    description: >-
      The workspace entity register: the firm itself, its clients, and its
      counterparties.
paths:
  /v2/account-connections/{id}/imports/{importId}:
    get:
      tags:
        - Account Connections
      summary: Get the result of a custom-connection import
      description: Status, upsert counts, and per-row validation errors.
      operationId: getImport
      parameters:
        - name: id
          required: true
          in: path
          description: Resource identifier.
          schema:
            type: string
            example: 550e8400-e29b-41d4-a716-446655440000
            format: uuid
        - name: importId
          required: true
          in: path
          description: Resource identifier.
          schema:
            type: string
            example: 550e8400-e29b-41d4-a716-446655440000
            format: uuid
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImportStatusResponseDto'
components:
  schemas:
    ImportStatusResponseDto:
      type: object
      properties:
        import_id:
          type: string
          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
        status:
          type: string
          enum:
            - processing
            - completed
            - failed
        accounts_upserted:
          type: number
          example: 2
        snapshots_upserted:
          type: number
          example: 10
        movements_upserted:
          type: number
          example: 4
        fiat_lines_ignored:
          type: number
          example: 1
          description: >-
            Books connections only: ISO-4217 lines with no token address, which
            a books import does not write.
        file_sha256:
          type: string
          nullable: true
          example: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
          description: >-
            SHA-256 of the uploaded file bytes. Null for imports created before
            the digest was stored.
        errors:
          type: array
          items:
            $ref: '#/components/schemas/ImportRowErrorDto'
        errors_truncated:
          type: number
          example: 0
          description: Row errors omitted after the stored cap.
        wallets:
          type: array
          items:
            $ref: '#/components/schemas/BooksImportWalletDto'
        unmatched:
          type: array
          items:
            $ref: '#/components/schemas/BooksImportUnmatchedDto'
        conflicts:
          type: array
          items:
            $ref: '#/components/schemas/BooksImportConflictDto'
      required:
        - import_id
        - status
        - accounts_upserted
        - snapshots_upserted
        - movements_upserted
        - file_sha256
        - errors
        - errors_truncated
    ImportRowErrorDto:
      type: object
      properties:
        file:
          type: string
          enum:
            - snapshots
            - movements
        row:
          type: number
          example: 2
        code:
          type: string
          enum:
            - VALIDATION_ERROR
            - PAYLOAD_TOO_LARGE
            - CLIENT_AMBIGUOUS
            - SERVER_ERROR
          description: >-
            `CLIENT_AMBIGUOUS` is a warning: the account was written but matches
            several custodian wallets, so it was not assigned to a client.
            `SERVER_ERROR` means the statement was not written because of a
            server failure; upload it again.
        message:
          type: string
          example: quantity must be a decimal string
          description: >-
            Present on every connection except a books connection, whose errors
            carry only the code.
      required:
        - file
        - row
        - code
    BooksImportWalletDto:
      type: object
      properties:
        wallet_account_id:
          type: string
        wallet_name:
          type: string
        client_entity_id:
          type: string
        client_name:
          type: string
        network:
          type: string
        books_account_id:
          type: string
        created_account:
          type: boolean
        statements:
          type: number
        snapshots:
          type: number
        movements:
          type: number
        books_through:
          type: string
          nullable: true
        reruns:
          type: array
          items:
            $ref: '#/components/schemas/BooksImportRerunDto'
      required:
        - wallet_account_id
        - wallet_name
        - client_entity_id
        - client_name
        - network
        - books_account_id
        - created_account
        - statements
        - snapshots
        - movements
        - books_through
        - reruns
    BooksImportUnmatchedDto:
      type: object
      properties:
        statement_index:
          type: number
        external_id:
          type: string
        network:
          type: string
          nullable: true
        reason:
          type: object
      required:
        - statement_index
        - external_id
        - network
        - reason
    BooksImportConflictDto:
      type: object
      properties:
        statement_index:
          type: number
        external_id:
          type: string
        network:
          type: string
        wallet_account_id:
          type: string
        existing_books_account_id:
          type: string
        existing_connection_id:
          type: string
      required:
        - statement_index
        - external_id
        - network
        - wallet_account_id
        - existing_books_account_id
        - existing_connection_id
    BooksImportRerunDto:
      type: object
      properties:
        month:
          type: string
          example: 2026-10
        run_id:
          type: string
          nullable: true
        reason:
          type: string
          enum:
            - no_run
            - not_enrolled
            - in_progress
            - not_queued
          description: >-
            `in_progress`: a run for the month was already in progress, so this
            wallet reruns after it finishes. `not_queued`: the rerun could not
            be admitted; re-sync the wallet to run it.
      required:
        - month
        - run_id
  securitySchemes:
    Authorization:
      type: apiKey
      in: header
      name: X-API-KEY
      description: Authorization method required to allow user to access the api endpoints.

````

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