Get Report

Read a report and its columns.

GET /api/v1/reports/{report_id}

cURL

curl "https://api.wordsmith.ai/api/v1/reports/f544ddfc-24d5-4947-939c-ba2d1bcba35b" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

Response

{
  "id": "f544ddfc-24d5-4947-939c-ba2d1bcba35b",
  "name": "Lease abstract: retail estate",
  "description": "Key terms for every signed retail lease.",
  "repository_id": "b23066a1-44cb-4b31-8b44-c723dc507d9b",
  "row_count": 214,
  "column_count": 3,
  "status": "idle",
  "columns": [
    {
      "id": "6294d0a0-e64f-41ba-96c5-47eb505e7ab0",
      "name": "Governing law",
      "prompt": "Which law governs this lease?",
      "type": "single_select",
      "options": ["England and Wales", "Scotland", "Northern Ireland"]
    },
    {
      "id": "a7335c50-fd65-45ec-90d7-b0b0341eb148",
      "name": "Term end date",
      "prompt": "On what date does the contractual term end?",
      "type": "date",
      "options": []
    },
    {
      "id": "56cdb1cf-a2ea-4102-ad7e-dfa91c94c897",
      "name": "Tenant break right",
      "prompt": "Does the tenant have a right to end the lease early?",
      "type": "boolean",
      "options": []
    }
  ],
  "url": "https://app.wordsmith.ai/reports/f544ddfc-24d5-4947-939c-ba2d1bcba35b",
  "created_at": "2026-10-13T09:20:00Z",
  "updated_at": "2026-10-13T09:42:18Z"
}

Preview. This endpoint is available to organisations in the Wordsmith MCP pilot. Other organisations receive 403 mcp_not_enabled. See the preview overview.

Returns one report with its columns. status is running while a run is computing cells, and idle otherwise.

The response does not include rows or cells, because a large grid holds thousands of them. Page through them with List Rows and List Cells.

A column made in the app with a type the API does not create, such as a Smart Cell, a URL or a JSON column, is listed with type text.

Authentication

Requires an API key, or an OAuth token with reports:read.

Path parameters

report_id · string · required

The report id.

Response

Returns 200 with the report, plus columns: every column in display order.

cURL

curl "https://api.wordsmith.ai/api/v1/reports/f544ddfc-24d5-4947-939c-ba2d1bcba35b" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

Response

{
  "id": "f544ddfc-24d5-4947-939c-ba2d1bcba35b",
  "name": "Lease abstract: retail estate",
  "description": "Key terms for every signed retail lease.",
  "repository_id": "b23066a1-44cb-4b31-8b44-c723dc507d9b",
  "row_count": 214,
  "column_count": 3,
  "status": "idle",
  "columns": [
    {
      "id": "6294d0a0-e64f-41ba-96c5-47eb505e7ab0",
      "name": "Governing law",
      "prompt": "Which law governs this lease?",
      "type": "single_select",
      "options": ["England and Wales", "Scotland", "Northern Ireland"]
    },
    {
      "id": "a7335c50-fd65-45ec-90d7-b0b0341eb148",
      "name": "Term end date",
      "prompt": "On what date does the contractual term end?",
      "type": "date",
      "options": []
    },
    {
      "id": "56cdb1cf-a2ea-4102-ad7e-dfa91c94c897",
      "name": "Tenant break right",
      "prompt": "Does the tenant have a right to end the lease early?",
      "type": "boolean",
      "options": []
    }
  ],
  "url": "https://app.wordsmith.ai/reports/f544ddfc-24d5-4947-939c-ba2d1bcba35b",
  "created_at": "2026-10-13T09:20:00Z",
  "updated_at": "2026-10-13T09:42:18Z"
}

Errors

Status	error_code	When
404	resource_not_found	No report with this id, the caller cannot read it, or it is on the legacy report engine.