---
title: "List Datasets"
method: GET
path: "/v1/datasets"
tags: ["Datasets"]
---

# List Datasets

`GET /v1/datasets`

Retrieve all datasets available for your team including jobs, companies, and technographics. Datasets are updated daily in Parquet format. Use this endpoint to get the latest download URLs for bulk data access.

## Response `200`

Successful Response

- DatasetGroup[]
  - `type` 'jobs' | 'companies' | 'technologies' | 'technographics' | 'buying_intents' | 'buying_intent_topics' | 'jobs_closed', nullable — Dataset type
  - `name` string, nullable — Human-readable dataset type name
  - `description` string, nullable — Description of the dataset
  - `is_accessible` boolean, nullable — Is this dataset accessible for the user based on their paid plan?
  - `options` DatasetOption[], nullable — Options of the dataset
    - `id` string, required — ID of the dataset option
    - `description` string, nullable — Description of the dataset option
    - `item_type` 'file' | 'folder' — Type of the dataset option. If it is a folder, it means that the dataset is a folder and the path is the path of the folder. In this case, path will have a value and dataset_url will be null. If it is a file, it means that the dataset is a file and the dataset_url will have a value, and path will be null.
    - `format` 'csv' | 'parquet', required — Format of the dataset
    - `frequency` 'hourly' | 'daily' | 'weekly' | 'monthly'
    - `version` string, required — Version of the dataset
    - `is_deprecated` boolean, nullable — Is this dataset deprecated? If yes, it means that this dataset is no longer available for download.
    - `dataset_prefix` string, nullable — S3/R2 path prefix URL for listing and accessing datasets (for use with temporary credentials to list files)
    - `dataset_url` string, nullable — URL of the dataset
    - `dictionary_url` string, nullable — URL of the dictionary
    - `sample_dataset_url` string, nullable — URL of the sample dataset
    - `last_updated` string, date-time, nullable — Last updated date of the dataset
    - `size` integer, nullable — Size of the dataset in bytes

## Other responses

- `400` — Bad Request
- `402` — Payment Required
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/theirstack/apis/theirstack-api-reference.md) · [All operations](https://skmtc.net/theirstack/apis/theirstack-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/theirstack/theirstack-api-reference/versions/2723cd54b43e/schema)