How This Helps
This API call allows you to programmatically check the current status of a dataset—including readiness, progress, and metadata—using its unique
dataset_id
.API Request
To retrieve the status of a dataset, send aGET
request to the following endpoint:
Example Request
Example Output
Dataset Status Values
Thestatus
field in the response can have the following values:
NEW
- Dataset has been created but not yet started processingPRE_PROCESSING
- Dataset is being prepared for processingINITIALIZING
- Dataset processing is being initializedUPLOADING
- Data is being uploaded to the systemSAVING
- Dataset data is being savedINDEXING
- Dataset is being indexed for search and retrievalREADY
- Dataset is fully processed and ready for useFATAL_ERROR
- An error occurred during processing that prevents completionENRICHING
- Dataset is being enriched with additional metadata or processing
Use this endpoint to track dataset readiness before continuing with enrichment, filtering, or export operations.