List datasets with pagination

Server-side paginated dataset listing with optional pipeline type filter and search

GET /api/v1/datasets/list

List datasets with pagination

cURL

curl --request GET \
  --url https://api.example.com/api/v1/datasets/list \
  --header 'Authorization: Bearer <token>'

200

{
  "datasets": [
    {
      "dataset_id": "<string>",
      "source_type": "<string>",
      "row_count": 123,
      "created_at": "<string>",
      "updated_at": "<string>",
      "session_id": "<string>",
      "status": "<string>",
      "pipeline_type": "<string>",
      "leads_count": 123,
      "processed_count": 123,
      "failed_count": 123,
      "progress_percentage": 123,
      "filename": "<string>",
      "session_created_at": "<string>",
      "session_updated_at": "<string>",
      "completed_at": "<string>"
    }
  ],
  "total_count": 123,
  "page": 123,
  "page_size": 123
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

pipeline_type · enum<string> | null

Pipeline type filter: enrichment, personalization, extraction, or null for all

Available options: enrichment, personalization, extraction

search · string | null

Search by dataset name

page · integer · default: 1

Page number (1-indexed)

Required range: x >= 1

page_size · integer · default: 20

Items per page (max 100)

Required range: 1 <= x <= 100

Response

200

application/json

Successful Response

datasets · DatasetWithLatestSession · object[] · required

List of datasets

Show child attributes

total_count · integer · required

Total number of datasets matching criteria

page · integer · required

Current page number

page_size · integer · required

Number of items per page