---
title: "List Compatible Datasets"
method: POST
path: "/datasets/compatible"
tags: ["datasets"]
---

# List Compatible Datasets

`POST /datasets/compatible`

## Request body

- CompatibleDatasetsRequest
  - `column_names` string[], required — List of column names to match against existing datasets
  - `workspace_id` string, uuid, nullable — Filter by workspace_id

## Response `200`

Successful Response

- Datasets
  - `items` Dataset[], required
    - `id` string, uuid, required
    - `name` string, required
    - `guidelines` string, nullable
    - `allow_extra_metadata` boolean, required
    - `status` 'draft' | 'ready', required
    - `distribution` DatasetOverlapDistribution, required
      - `strategy` 'overlap', required
      - `min_submitted` integer, required
    - `metadata` object, nullable
    - `mapping` DatasetMapping
      - `fields` DatasetMappingItem[], required
        - `source` string, required — The name of the column in the Hub Dataset
        - `target` string, required — The name of the target resource in the Extralit Dataset
      - `metadata` DatasetMappingItem[], nullable
        - `source` string, required — The name of the column in the Hub Dataset
        - `target` string, required — The name of the target resource in the Extralit Dataset
      - `suggestions` DatasetMappingItem[], nullable
        - `source` string, required — The name of the column in the Hub Dataset
        - `target` string, required — The name of the target resource in the Extralit Dataset
      - `source_id` string, nullable — Dataset-level source identifier (format: import:{import_id}, dataset:{dataset_id}, hub:{repo_id})
      - `target_id` string, nullable — Dataset-level target identifier for workflow tracking
    - `workspace_id` string, uuid, required
    - `current_schema_version_id` string, uuid, nullable
    - `last_activity_at` string, date-time, required
    - `inserted_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Content
- `500` — Internal Server Error

---

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