Cases

Discover the corpora you can query. See Cases & corpora.

Method	Path
GET	/api/v1/cases

List cases

GET /api/v1/cases

All corpora with node counts and availability.

From the API schema: Public. The corpora (cases) that can be chatted with, searched and explored in 3D.

Auth: Public — no credentials

cURL

curl "https://vol.example.com/api/v1/cases"

TypeScript

import { VolClient } from "@vol/sdk";

const vol = new VolClient({ baseUrl: "https://vol.example.com/api" });
await vol.cases();

Python

import os, requests

r = requests.get(
    "https://vol.example.com/api/v1/cases",
    timeout=60,
)
r.raise_for_status()
print(r.json())

Response 200

[
  {
    "id": "papers",
    "name": "Scientific papers",
    "description": "Peer-reviewed literature.",
    "nodes": 7656,
    "available": true,
    "graphVersion": "ragflow_v2"
  },
  {
    "id": "trials",
    "name": "Clinical trials",
    "description": "Registered clinical trials.",
    "nodes": 0,
    "available": false,
    "graphVersion": null
  }
]

Types

interface CaseInfo { id: CaseId; name: string; description: string; nodes: number; available: boolean; graphVersion: string | null }

type CaseId = "papers" | "cordis" | "patents" | "trials";