List 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.

GET/v1/workspaces/{workspaceId}/datasets

Authentication

Send your Graphon API key with every request. The value is the whole API key that Graphon showed when you created it. See Authentication.

Authorization: Bearer <GRAPHON_API_KEY>

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

Request

Loading your session…

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
}

Path parameters

workspaceIdstring

The workspace id.

Query parameters

categorystring (optional)

Only this category. One of: legal, commerce, people, government, science, other.

qstring (optional)

Words of the title or the summary.

cursorstring (optional)

nextCursor from the previous page.

limitstring (optional)

a string to be decoded into a number

Was this page helpful?

View as Markdown