---
title: "List datasources"
method: GET
path: "/api/v1/datasources"
tags: ["Datasources"]
---

# List datasources

`GET /api/v1/datasources`

This endpoint allows you to list datasources in your organization.

This GET is a paginated API that uses the following parameters to request specific details:

- `size`: Supply an integer value between 10 and 1000, inclusive. The default value is 10.

- `page`: Supply an integer value. The default value is 0.

- `search`: Supply a string value to filter datasources by name (case-insensitive partial match).

## Authorization

Soda only returns datasources for which the user has the **View** permission. Soda Cloud Admins have access to all datasources.

## Authentication

User authentication required: `true`

This endpoint accepts authentication via API keys in the `Basic` authentication header, or a pre-authenticated token in HTTP cookie `token`. Cookie sessions extend automatically on each request.

## Tags

`Datasources`

## Rate limiting

60 requests/60 seconds

## Query parameters

- `page` integer
- `search` string
- `size` integer

## Response `200`

Successful response

- PublicApiListDatasourcesResponse
  - `content` PublicApiDatasourceDTO[], required
    - `createdAt` string, date-time
    - `id` string
    - `label` string
    - `name` string
    - `type` 'bigquery' | 'mysql' | 'postgres' | 'snowflake' | 'dask' | 'spark' | 'sparkdf' | 'redshift' | 'duckdb' | 'presto' | 'oracle' | 'athena' | 'trino' | 'dremio' | 'vertica' | 'denodo' | 'db2' | 'db2z' | 'sqlserver' | 'databricks' | 'synapse' | 'fabric'
    - `updatedAt` string, date-time
  - `first` boolean, required
  - `last` boolean, required
  - `number` integer, required
  - `size` integer, required
  - `totalElements` integer, required
  - `totalPages` integer, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Too many requests
- `500` — Internal server error

---

[API](https://skmtc.dev/soda/apis/soda-cloud-api-v4.md) · [All operations](https://skmtc.dev/soda/apis/soda-cloud-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/soda/soda-cloud-api-v4/revisions/ce87192b6b72/schema)