---
title: List datasets
description: Returns the published datasets, most recently indexed first, with what the calling workspace can do with each one.
doc_version: 0.1.0-preview
last_updated: 2026-09-14
---

# List datasets

`GET /v1/workspaces/{workspaceId}/datasets`

Returns the published datasets, most recently indexed first, with what the calling workspace can do with each one. A dataset is free, or paid: a paid dataset says locked until the workspace has access. A dataset is not a bucket: it counts toward no storage, and a query of it counts like a query of a bucket. Requires the viewer role.

## Authentication

Send `Authorization: Bearer <GRAPHON_API_KEY>`. Read the key from the
GRAPHON_API_KEY environment variable. Never print it.

## Path parameters

- `workspaceId` (string) — The workspace id.

## Query parameters

- `category` (string (optional)) — Only this category. One of: legal, commerce, people, government, science, other.
- `q` (string (optional)) — Words of the title or the summary.
- `cursor` (string (optional)) — nextCursor from the previous page.
- `limit` (string (optional)) — a string to be decoded into a number

## Example request

```bash
curl \
  --url "https://api.beta.graphon.ai/v1/workspaces/wspq7ws2np5l8z4/datasets" \
  --header "Authorization: Bearer $GRAPHON_API_KEY"
```

## CLI

```bash
graphon datasets list --category legal
```

## Example response

```json
{
  "datasets": [
    {
      "id": "dstC4s3L4w0x1",
      "slug": "us-case-law",
      "title": "US case law",
      "summary": "Opinions of the US Supreme Court and the federal courts of appeals.",
      "description": "Every published opinion of the US Supreme Court since 1950, and of the federal courts of appeals since 2000, as plain text.",
      "category": "legal",
      "source": {
        "name": "CourtListener",
        "url": "https://www.courtlistener.com",
        "license": "Public domain"
      },
      "documentCount": 412904,
      "indexedBytes": "8392045113",
      "indexedAt": "2026-10-26T04:12:00.000Z",
      "examples": [
        {
          "query": "Which cases overruled Chevron?",
          "mode": "answer"
        }
      ],
      "access": {
        "price": {
          "kind": "free"
        },
        "state": "open"
      }
    }
  ],
  "nextCursor": null
}
```

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.