System Atlas
SystemAtlas

Get a research run

Progress and result of a research run: status, pages read, components and values written, cost.

GET/api/v1/workspaces/:slug/research/:runNeeds a key

Authentication

Authorization: Bearer sa_… (any valid key; reads also accept a signed-in browser session).

Parameters

Path

  • slugstringrequired

    Workspace slug

  • runstringrequired

    Run id from start research

Request

curl "https://systematlas.org/api/v1/workspaces/acme-builders/research/8f0c2a4e-1b7d-4c55-9a8e-3d2f6b1c0e91" \
  -H "Authorization: Bearer sa_…"

Response

200 with the result in data (abbreviated here). Errors are listed in Errors and limits.

Response
{
  "data": {
    "id": "8f0c2a4e-1b7d-4c55-9a8e-3d2f6b1c0e91",
    "status": "done",
    "pagesRead": 14,
    "componentsWritten": 38,
    "valuesWritten": 61,
    "costUsd": 0.21,
    "error": null
  }
}

Over MCP

The same call as an MCP tool: get_research.

PreviousCompare companiesNext Get the mapping guide