---
title: "List Data Stores"
method: GET
path: "/v1/data-discovery/data-stores"
tags: ["dataDiscovery"]
---

# List Data Stores

`GET /v1/data-discovery/data-stores`

## Request

- Base URL: `https://api.osano.com`
- URL: `https://api.osano.com/v1/data-discovery/data-stores`
- Auth: API key in header `x-osano-api-key`
- TypeScript: <https://skmtc.dev/osano/apis/osano-api-reference/docs/v1/data-discovery/data-stores/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of Data Stores.  Results are sorted in descending order by creation time.  The number of results returned may be controlled via the limit param, but may not exceed 500.  The "next" object in the response may be used to retrieve subsequent pages of the same resource.

## Query parameters

- `limit` integer
- `next` string
- `after` string
- `connectorId` integer
- `active` boolean
- `name` string
- `type` 'internal' | 'saas' | 'onprem'

## Response `200`

Success

- DataStoreResponseList
  - `items` DataStoreResponse[], required
    - `dataStoreId` integer
    - `name` string
    - `status` string, nullable: The sync status of the data store (e.g., QUEUED, SYNCED, FAILED). Null for internal data stores.
    - `lastSync` string, date-time, nullable: The timestamp of the last sync operation
    - `description` string
    - `alias` string
    - `type` string
    - `active` boolean
    - `created` string, date-time
    - `connector` Connector
      - `connectorId` integer, required
      - `productName` string, required
      - `authType` string, required
    - `owners` DataStoreOwner[]
      - `email` string, email, required
      - `primary` boolean
    - `totalFields` integer: Total count of fields in the data store
    - `unclassifiedFields` integer: Count of fields that have not been classified
    - `fieldsWithUserData` integer: Count of fields that contain user data
    - `metadata` object
    - `labels` DataStoreLabels[]
      - `name` string, required
      - `labelId` string, uuid, nullable
  - `next` string: A token which may be appended to subsequent requests to retrieve the next page of results, i.e. ?next=...

## Other responses

- `400`: Bad Request

## Changes

- **2026-05-12** `4fc37598750d`: 1 warning, 7 info
  - for the `query` request parameter `limit`, the min was set to `1.00`
  - added the optional property `items/items/fieldsWithUserData` to the response with the `200` status
  - added the optional property `items/items/labels` to the response with the `200` status
  - added the optional property `items/items/lastSync` to the response with the `200` status
  - …4 more

[Operation history](https://skmtc.dev/osano/apis/osano-api-reference/changes/v1/data-discovery/data-stores/get.md)

---

[API](https://skmtc.dev/osano/apis/osano-api-reference.md) - [All operations](https://skmtc.dev/osano/apis/osano-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/osano/apis/osano-api-reference/revisions/ac31099cf83e?raw)