Get a dataset

Returns one published dataset by its id or its slug: its description, size, source, license, examples, and access. A draft, retired, or unknown dataset is 404 not_found. Requires the viewer role.

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

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/dstC4s3L4w0x1" \
  --header "Authorization: Bearer $GRAPHON_API_KEY"

Request

Loading your session…

Response

JSON

{
  "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"
  }
}

Path parameters

workspaceIdstring

The workspace id.

datasetIdstring

The dataset id (dst…) or its slug.

Was this page helpful?

View as Markdown