---
title: "Get import source by ID"
method: GET
path: "/importsource/{id}"
---

# Get import source by ID

`GET /importsource/{id}`

Retrieves a specific import source configuration by its ID. If scheduled imports are enabled, the response includes scheduling information.

## Response `200`

Import source found

- ImportSourceResponse
  - `id` string, uuid — Import source ID
  - `collectionId` string, uuid — Collection (object schema) ID
  - `name` string — Import source name
  - `created` string, date-time — Timestamp when the import source was created
  - `updated` string, date-time — Timestamp when the import source was last updated
  - `description` string, nullable — Import source description
  - `objectSchemaId` string, uuid — Object schema ID
  - `importSourceModuleKey` 'rlabs-import-type-csv' | 'rlabs-import-type-json' | 'rlabs-import-type-external' | 'insight-discovery-import' | 'rlabs-import-type-dm-csv' — Import module type. CSV: rlabs-import-type-csv, JSON: rlabs-import-type-json, External: rlabs-import-type-external, Discovery: insight-discovery-import, DataManager: rlabs-import-type-dm-csv
  - `defaultConcatenator` string — Default concatenator for multi-value attributes
  - `defaultHandleEmptyValues` string — How to handle empty values
  - `defaultHandleUnknownValues` string — How to handle unknown values
  - `dateFormat` string — Date format pattern
  - `dateTimeFormat` string — Date-time format pattern
  - `importStatus` object, nullable — Import status information
    - `configurationStatusType` 'DISABLED' | 'ENABLED', nullable — Configuration status type - whether the import source is enabled or disabled
    - `validationStatusType` 'VALID' | 'INVALID_CONFIGURATION' | 'MODULE_UNINSTALLED', nullable — Validation status type - system-evaluated status (not user-changeable)
    - `reasonForInvalidity` object, nullable — Map of reasons for invalidity
    - `name` string — Status name (computed from configurationStatusType)
    - `validation` string — Validation status name (computed)
    - `configurationAuiLozenge` string — AUI lozenge CSS class for configuration status
    - `validationAuiLozenge` string — AUI lozenge CSS class for validation status
  - `importSpecificConfiguration` string — Import-specific configuration as JSON string
  - `importSourceOTEntries` object[], nullable — List of object type mappings for this import source
    - `id` string — Import source object type ID
    - `parentImportSourceOTId` string, nullable — Parent import source object type ID
    - `importSourceId` string, nullable — Associated import source ID
    - `created` string, date-time, nullable — Creation timestamp
    - `updated` string, date-time, nullable — Last update timestamp
    - `description` string, nullable — Description
    - `objectType` object, nullable — Target object type configuration
      - `id` string — Object type ID
      - `name` string — Object type name
    - `selectorQlQuery` string, nullable — Selector QL query
    - `selectorIQL` string, nullable — Selector IQL query
    - `selector` string, nullable — The selector used in JSON imports to find the objects
    - `emptyValues` string, nullable — How to handle empty values
    - `unknownValues` string, nullable — How to handle unknown values
    - `importStatus` object, nullable — Import status for this object type
      - `configurationStatusType` 'DISABLED' | 'ENABLED' — Configuration status type
      - `validationStatusType` 'VALID' | 'INVALID_CONFIGURATION' | 'MODULE_UNINSTALLED' — Validation status type
      - `reasonForInvalidity` object — Reasons for invalidity
    - `importSourceOTAttrEntries` object[], nullable — List of object type attribute mappings
      - `id` string — Attribute mapping ID
    - `matchIdentifierIgnoreCase` boolean, nullable — Whether to ignore case when matching identifiers
  - `tokenGenerated` boolean, nullable — Whether a token has been generated for this import source
  - `url` string, uri, nullable — Import source URL (if applicable)
  - `integratedImportTypeId` integer, nullable — Integrated import type ID
  - `integratedImportTypeExtensionId` string, nullable — Integrated import type extension ID
  - `defaultHandleComputeIssueValues` string, nullable — How to handle computed issue values (DataManager config)
  - `defaultHandleNullValues` string, nullable — How to handle null values (DataManager config)
  - `defaultHandleNotMappedValues` string, nullable — How to handle not mapped values (DataManager config)
  - `isImportSourceSchedulingEnabled` boolean, nullable — Whether scheduled import is enabled for this source
  - `importExecutionType` string, nullable — Type of import execution
  - `scheduledImportDetails` ScheduledImportDetails
    - `importScheduleId` string, uuid — Schedule ID
    - `startTime` string, date-time — When the schedule starts
    - `runFrequency` 'ONCE' | 'DAILY' | 'WEEKLY' | 'MONTHLY' — The frequency of the scheduled import. ONCE: runs only at startTime. DAILY: runs every day at the specified time. WEEKLY: runs every 7 days. MONTHLY: runs on the same day of each month.
    - `nextScheduledTime` string, date-time — Next scheduled execution time
    - `createdAt` string, date-time — When the schedule was created

## Other responses

- `401` — Client must be authenticated to access this resource.
- `403` — Authenticated user is missing permission to fulfill the request
- `404` — Representation of the target resource do not exist
- `500` — Something went wrong. Please try again later. If the error persists, contact our support team.

---

[API](https://skmtc.net/atlassian/apis/rest.md) · [All operations](https://skmtc.net/atlassian/apis/rest/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/rest/versions/07137e668210/schema)