List datasets for the current customer | Dadosfera AutoDriveDDF API

Time	Status	User Agent
Retrieving recent requests…

Time

Status

User Agent

Retrieving recent requests…

Description

List every dataset that belongs to your account.
Useful to:

Build dashboards of ingestion volumes.
Locate a dataset_id for follow-up queries.
Audit status (processing, success, failed, …).

HTTP Request

GET /datasets
(no path parameters)

Authentication

In your REST client (Postman/Insomnia), select Basic Auth and enter your Username and Password.

The client will automatically generate the Authorization: Basic … header for you. Do not add that header manually.

Request Headers

Header	Example	Required	Notes
Authorization	`Basic YWRtaW46bXlwYXNzd29yZA==`	✓	HTTP Basic Auth – always use HTTPS.
Accept	`application/json`	—	Guarantees JSON response.

Query Parameters

Name	Type	Default	Description
limit	integer	`20`	Page size (max = 100).
offset	integer	`0`	Number of datasets to skip (for pagination).
name	string	—	Case-insensitive substring match on the dataset’s name.
status	string	—	Filter by status: `success`, `processing`, `failed`, `updating`.

Example Request (cURL)

curl -u admin:mypassword \
     "https://api.autodriveddf.example/datasets?limit=50&status=success"

Success Response `200 OK`

[
  {
    "dataset_id": "c8004e22-87f7-441f-8302-80c934841196",
    "id": 31,
    "name": "platform_knowledge_base",
    "status": "success",
    "status_reason": null,
    "customer_name": "dadosferaDemo",
    "instance_id": "78b9e8c0-a123-4e56-9f01-abcdef123456",
    "created_at": "2025-05-04T14:46:58.802Z",
    "updated_at": "2025-06-12T11:20:03.441Z"
  },
  {
    "dataset_id": "d1f2c3b4-1111-2222-3333-444455556666",
    "id": 32,
    "name": "analytics_logs",
    "status": "processing",
    "status_reason": null,
    "customer_name": "dadosferaDemo",
    "instance_id": "78b9e8c0-a123-4e56-9f01-abcdef123456",
    "created_at": "2025-06-10T09:00:00.000Z",
    "updated_at": "2025-06-10T09:00:00.000Z"
  }
]

Field	Description
dataset_id	Canonical UUID – use this for subsequent API calls.
id	Internal numeric identifier (rarely needed).
name	Human-friendly dataset name.
status	`success`, `processing`, `failed`, or `updating`.
status_reason	Non-null only if `status = failed`.
customer_name	Tenant / account identifier.
instance_id	Internal processing instance (audit/debug).
created_at	Dataset creation timestamp (ISO-8601).
updated_at	Last time files were added or status changed.

Error Responses

Code	Reason	When it happens	Example Body
401	Unauthorized	Missing / wrong Basic Auth credentials	—
400	Bad Request	Malformed query parameter (e.g., non-integer `limit`)	`{ "detail": "limit must be a positive int." }`
500	Server Error	Unexpected issue while fetching dataset list	`{ "detail": "Unexpected error." }`

Pagination Workflow

Use limit + offset to paginate:

GET /datasets?limit=50&offset=0     → first 50
GET /datasets?limit=50&offset=50    → next 50