List filing extractions

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://docs.usehearsay.com/mcp

Standard setup for AI tools providing an mcp.json file

{
  "integrations MCP server": {
    "url": "https://docs.usehearsay.com/mcp"
  }
}

GET /ai/cases/{caseId}/context/extractions

Access token

Lists the latest 50 filing extractions of the case, newest first, with their status and, once completed, the raw extraction. Requires commenter access or above to the case and an active plan (403 otherwise); not available to opposing counsel.

Path parameters

caseId string Required

Responses

200 application/json
Hide response attributes Show response attributes object
- data array[object] Required
  
  Hide data attributes Show data attributes object
  
  _id string
  
  case string
  
  organization string
  
  caseFile string
  
  status string
  
  Values are queued, running, completed, or failed.
  
  rawExtraction object | null
  
  The model output, kept as returned.
  
  appliedAt string(date-time) | null
  
  appliedBy string | null
  
  appliedFields array[string]
  
  modelVersion string | null
  
  promptVersion string | null
  
  errorMessage string | null
  
  createdAt string(date-time) | null
  
  updatedAt string(date-time) | null
- statusCode number Required
- timestamp string(date-time) Required

GET /ai/cases/{caseId}/context/extractions

curl \
 --request GET 'http://api.example.com/ai/cases/{caseId}/context/extractions' \
 --header "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

{
  "data": [
    {
      "_id": "65a1b2c3d4e5f6a7b8c9d0e1",
      "case": "65a1b2c3d4e5f6a7b8c9d0e2",
      "organization": "65a1b2c3d4e5f6a7b8c9d0e3",
      "caseFile": "65a1b2c3d4e5f6a7b8c9d0e5",
      "status": "completed",
      "rawExtraction": {},
      "appliedAt": "2026-01-15T10:15:00.000Z",
      "appliedBy": "65a1b2c3d4e5f6a7b8c9d0e4",
      "appliedFields": [
        "caseType",
        "legalClaims"
      ],
      "modelVersion": "string",
      "promptVersion": "case_context_filing_extraction.v1",
      "errorMessage": "string",
      "createdAt": "2026-01-15T10:15:00.000Z",
      "updatedAt": "2026-01-15T10:15:00.000Z"
    }
  ],
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}