Create dataset
Creates a new dataset from a list of existing entity IDs. The optional description field here describes the dataset itself — it is separate from the entity-level description used for matching.
Entities must be created before adding them to a dataset. Each entity requires a name plus at least one of: a description or a domain. Use Create entity or Create entities batch to create entities first.
If any of the provided entity IDs do not exist or do not belong to
your organization, the request fails with 400. All entity IDs must
be valid before the dataset is created.
To create a dataset and entities in one step, use the Create dataset from CSV
endpoint instead.
Authorizations
API key for authentication.
Body
Name for the dataset.
1"My Portfolio"
Optional description.
"Companies in our investment portfolio"
IDs of existing entities to include in the dataset. All IDs must belong to the authenticated organization. If any ID is invalid or not found, the request fails with 400.
Response
Full dataset object with metadata and current status.
Unique identifier of the dataset.
"ccabb755-afc2-4047-b84c-78d1f23d49b2"
Organization that owns this dataset.
"e5d9e9b0-e415-4941-8ef0-916c5ee56207"
Dataset name.
"My Portfolio"
Optional description.
"Companies in our investment portfolio"
Total number of entities in this dataset.
4
Count of entities grouped by processing status. Keys are status values
(ready, pending, enriching, failed); values are entity counts.
Overall health score of the dataset, from 0 to 100. Reflects how many entities have sufficient identifying information for reliable matching.
100
Health scores broken down by entity type. Keys are entity types
(e.g. company); values are scores from 0 to 100.
Processing status of a dataset.
pending: Dataset created, entities queued for enrichment.enriching: Entities are being enriched.ready: All entities enriched and indexed — ready for use in jobs.failed: One or more entity enrichments failed.
pending, enriching, ready, failed ID of the user who created this dataset.
"870e258e-12ec-4a47-8656-e7a43b0265b3"
ISO 8601 timestamp of when the dataset was created. Returned without timezone offset (server-local time).
"2026-04-08T15:21:36.026993"
ISO 8601 timestamp of when the dataset was last updated. Returned without timezone offset (server-local time).
"2026-04-08T15:21:38.401148"

