---
title: "List data import providers"
method: GET
path: "/data-import/providers"
tags: ["Data Import"]
---

# List data import providers

`GET /data-import/providers`

## Request

- Base URL: `https://api.surense.com/api/v1`
- URL: `https://api.surense.com/api/v1/data-import/providers`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.surense.com/oauth/token` scopes: `data_import:import`

Returns the import providers (e.g. an insurance company or a clearing house file format) the caller's tenant can import from, including disabled ones (`enabled: false`). Providers restricted to a specific tenant (`properties.tenantId`) are only returned to that tenant. Each provider describes its sub-providers, the accepted file extensions/name patterns, whether several files may be uploaded at once, and properties such as `managerRequired`, `validityMonthRequired`, `autoDetectSubProvider` and `cancelAllowed` that drive the `params` expected by `initiateDataImport`.

**Authorization:** requires the `data_import:import` scope.

## Response `200`

The providers available to the caller's tenant

- DataImportProviderDescriptor[]
  - `id` string, uuid
  - `name` string
  - `description` string
  - `properties` object
  - `subProviders` DataImportProviderDescriptor[]
  - `allowMultipleFiles` boolean
  - `acceptedFiles` object
  - `acceptedRegexes` string[]
  - `archiveRegexes` string[]
  - `archiveEntryRegexes` string[]
  - `filesValidator` object
  - `requiredFilesValidator` object
  - `groupKeyExtractor` object
  - `enabled` boolean
  - `taskDefinition` string

## Other responses

- `403`: The caller lacks the `data_import:import` scope

---

[API](https://skmtc.dev/surense/apis/data-import-api.md) - [All operations](https://skmtc.dev/surense/apis/data-import-api/llms.txt) - [OpenAPI document](https://skmtc.dev/surense/apis/data-import-api/revisions/cf169afb2d5b?raw)