List Datasets

List all datasets in the current organization.

GET /datasets

List Datasets

cURL

curl --request GET \
  --url https://api.woodwide.ai/datasets \
  --header 'Authorization: Bearer <token>'

200

{
  "datasets": [
    {
      "id": "a1b2c3d4-0000-0000-0000-000000000001",
      "name": "my_dataset",
      "description": null,
      "created_at": "2025-01-15T10:30:00Z",
      "updated_at": "2025-01-15T10:30:00Z",
      "current_version": {
        "version_number": 1,
        "status": "ready",
        "row_count": 1000,
        "column_count": 12
      }
    }
  ],
  "next_cursor": null
}

This endpoint uses cursor-based pagination ordered newest-first. See Pagination for a full example.

Authorizations

Authorization · string · header · required

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

Query Parameters

q · string | null

Case-insensitive substring search on dataset name. Returns datasets whose name contains the query string.

limit · integer · default: 50

Required range: 1 <= x <= 200

cursor · string | null

Pagination cursor

Response

200

application/json

Successful Response

Response for listing datasets.

Returns datasets in the current organization. Use the limit query parameter to control page size (default 50, max 200).

items · Dataset · object[] · required

Show child attributes

next_cursor · string | null