Retrieve a case · Docs

Retrieve a case#

GEThttps://api.vaelor.chat/v1/osint/cases/{id}

Returns the case with all of its runs, collected evidence and attached files.

Response

caseobject

The case: id, title, goal, material, createdAt, updatedAt.

runsobject[]

Every run, newest first.

idstring

Run ID.

statusenum

queued, running, reporting, completed, partial, cancelled or failed.

modelenum

flash, medium or high.

reportobject | null

When finished: markdown, plus entities and relationships that cite evidence IDs.

toolCountinteger

Number of tool calls the run made.

errorstring | null

Why the run failed, if it did.

evidenceobject[]

Every source collected: id, runId, kind (source, file or observation), source, title, excerpt, locator and retrievedAt.

filesobject[]

Attached files: id, name, mediaType and byteSize.

curl https://api.vaelor.chat/v1/osint/cases/a41f9c6e-2b8d-4e17-9f3a-6c0d5e8b2a91 \
  -H "Authorization: Bearer $VAELOR_API_KEY"

const detail = await fetch(`https://api.vaelor.chat/v1/osint/cases/${caseId}`, {
  headers: { Authorization: `Bearer ${process.env.VAELOR_API_KEY}` }
}).then((response) => response.json())

detail = requests.get(
    f"https://api.vaelor.chat/v1/osint/cases/{case_id}",
    headers={"Authorization": f"Bearer {os.environ['VAELOR_API_KEY']}"},
).json()

Response200

JSON

{
  "case": {
    "id": "a41f9c6e-2b8d-4e17-9f3a-6c0d5e8b2a91",
    "title": "Northwind Trading web footprint",
    "goal": "Map the public web footprint of the domain northwind-trading.example.",
    "material": "northwind-trading.example",
    "createdAt": "2026-10-20T08:02:19.000Z",
    "updatedAt": "2026-10-20T08:14:51.000Z"
  },
  "runs": [
    {
      "id": "r_7c1e4b02",
      "status": "completed",
      "goal": "Map the public web footprint of the domain northwind-trading.example.",
      "model": "medium",
      "toolCount": 14,
      "error": null,
      "createdAt": "2026-10-20T08:03:02.000Z",
      "report": {
        "markdown": "## Summary\nNorthwind Trading B.V. operates two domains…",
        "entities": [{ "name": "Northwind Trading B.V.", "type": "organization", "evidenceIds": ["e_19", "e_22"] }],
        "relationships": [{ "from": "northwind-trading.example", "to": "nwt-logistics.example", "description": "Shares MX records", "evidenceIds": ["e_24"] }]
      }
    }
  ],
  "evidence": [
    {
      "id": "e_19",
      "runId": "r_7c1e4b02",
      "kind": "source",
      "source": "web",
      "title": "About us — Northwind Trading",
      "excerpt": "Northwind Trading B.V. was founded in Rotterdam in 2019…",
      "locator": "https://northwind-trading.example/about",
      "retrievedAt": "2026-10-20T08:05:40.000Z"
    }
  ],
  "files": []
}

Delete a case#

DELhttps://api.vaelor.chat/v1/osint/cases/{id}

Permanently deletes the case, its runs, evidence and files. Stop any active run first.

Shell

curl -X DELETE https://api.vaelor.chat/v1/osint/cases/a41f9c6e-2b8d-4e17-9f3a-6c0d5e8b2a91 \
  -H "Authorization: Bearer $VAELOR_API_KEY"

Response200

JSON

{ "deleted": true }

Errors#

Status	When
`404`	No case with this ID exists in your account.
`409`	The case has an active run. Stop it first.