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

# Read import config



## OpenAPI

````yaml /openapi/public/openapi-importexport.json get /import-configs
openapi: 3.0.0
info:
  title: MileApp API - ImportExport
  version: 3.0.0
  description: MileApp API Documentation - RESTful API for field operations management.
servers:
  - url: https://apiweb.mile.app/api/v3
security:
  - bearerAuth: []
tags:
  - name: Data Import
    description: >-
      The Data Import module allows users to upload and import data source
      records from Excel or CSV files. Import operations are processed in the
      background via queue system for scalability and can handle large datasets.
      The import process validates data against data type schemas, tracks
      processing status in real-time, and generates detailed reports including
      failed records for review. All import activities can be monitored through
      import-monitoring endpoints with 30-day data retention.
  - name: Export Task
    description: >-
      The Export Task module provides functionality to export task data and data
      source records to various formats (XLSX, JSON). It supports both direct
      export for small datasets and background processing for large exports.
      Users can customize exports using export configurations, filter data by
      multiple criteria, and monitor export operations through export logs.
      Export files are stored securely with 30-day retention period.
  - name: Export Config
    description: >-
      The Export Config module is used to save and manage the specific fields
      that a user wants included in export results. This allows users to
      customize their exported data by selecting only the necessary fields for
      each export, ensuring that the output contains exactly the information
      they need.


      **To see the details of export config object, please follow [this
      link](#tag/export_config_model)**
  - name: Import Config
    description: >-
      The Import Config module saves and manages column mapping presets for bulk
      import features across MileApp. Users can store field-to-Excel-column
      mappings so they can be reused across multiple imports. Each config is
      linked to a specific resource and contains the mapping between its fields
      and Excel header columns.
paths:
  /import-configs:
    get:
      tags:
        - Import Config
      summary: Read import config
      operationId: getImportConfigs
      parameters:
        - name: referenceId
          in: query
          required: false
          description: |-
            Filter by reference ID (e.g., flow ID).
            **Example:** `66a988d53ae08a7ab52867c2`
          schema:
            type: string
        - name: sortOrder
          in: query
          required: false
          description: |-
            Sort order for results.
            **Example:** `asc` or `desc`.
            **Default:** `desc`
          schema:
            type: string
        - name: limit
          in: query
          required: false
          description: >-
            Limit of import config list. **Example:** `10`. **Default:** `20`.
            **Max:** `1000`
          schema:
            type: integer
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                properties:
                  status:
                    type: boolean
                    description: Status of response.
                  data:
                    description: Paginated list of import configs.
                    type: object
                    additionalProperties: true
                example:
                  status: true
                  code: 200
                  message: Success.
                  data:
                    current_page: 1
                    data:
                      - _id: 67b5a1234567890abcdef001
                        name: Delivery Order Import - Flow A
                        description: Column mapping preset for daily delivery order import
                        collection: task
                        referenceType: flow
                        referenceId: 66a988d53ae08a7ab52867c2
                        fields:
                          - id: orderNumber
                            headerColumn: Order No
                          - id: customerName
                            headerColumn: Customer
                          - id: billItem
                            sheet: Bill Items
                            fields:
                              - id: name
                                headerColumn: Item Name
                              - id: qty
                                headerColumn: Quantity
                              - id: unitPrice
                                headerColumn: Price
                        organizationId: 66791b2bf001a712b77b3622
                        updatedTime: '2026-02-19T08:30:00.000000Z'
                        createdTime: '2026-02-19T08:30:00.000000Z'
                    first_page_url: https://api.mile.app/api/v3/import-configs?limit=20&page=1
                    from: 1
                    last_page: 1
                    last_page_url: https://api.mile.app/api/v3/import-configs?limit=20&page=1
                    links:
                      - url: null
                        label: '« Previous'
                        active: false
                      - url: >-
                          https://api.mile.app/api/v3/import-configs?limit=20&page=1
                        label: '1'
                        active: true
                      - url: null
                        label: Next »
                        active: false
                    next_page_url: null
                    path: https://api.mile.app/api/v3/import-configs
                    per_page: 20
                    prev_page_url: null
                    to: 1
                    total: 1
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    description: Shows if the request was successful.
                  message:
                    type: string
                    description: A short message explaining what went wrong.
                example:
                  status: false
                  message: Bad request - invalid parameters provided.
        '500':
          description: Server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    description: Shows if the request was successful.
                  message:
                    type: string
                    description: A short message explaining what went wrong.
                example:
                  status: false
                  message: Internal server error, please contact support@mile.app.
      deprecated: false
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Use a valid Bearer token to authenticate.

````