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 a GET request to the following endpoint:

GET /api/v1/dataset/{dataset_id}
Headers: Authorization: Bearer <jwt>

​
Example Request

curl -H "Authorization: Bearer <jwt>" https://app.visual-layer.com/api/v1/dataset/{dataset_id}

​
Example Output

{
    "id": "DATASET_ID",
    "source_dataset_id": null,
    "owned_by": "VL",
    "display_name": "dataset1",
    "description": "",
    "source_type": "BUCKET",
    "created_at": "2025-04-24T07:44:46.136915",
    "filename": null,
    "sample": null,
    "status": "READY",
    "fatal_error_msg": null,
    "progress": 100,
}

Use this endpoint to track dataset readiness before continuing with enrichment, filtering, or export operations.

📌 For detailed reference, visit the Dataset Status API.