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.