Get data-collection status as a tree

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 /case/{caseId}/data-status-tree

Access token

Data-collection status as a tree of custodians, devices and sources. Kept as a fallback for data-status-tree-v3.

Headers

organization string Required

id of the selected (active) organization

Path parameters

caseId string Required

Id of the case

Query parameters

extractionCode string
searchText string
tags array[string]

Tag ids (comma-separated). Filters device conversations, emails, files, and financial sources. Excludes discord/reddit.
searchMatchType string

Match type for message text search. FUZZY allows typo tolerance, EXACT requires exact token match.

Values are FUZZY or EXACT. Default value is FUZZY.

Responses

200 application/json
Hide response attributes Show response attributes object
- data object Required
  
  Hide data attribute Show data attribute object
  
  data array[object] Required
  
  Hide data attributes Show data attributes object
  
  id string Required
  
  kind string Required
  
  sourceId string
  
  sourceName string | null
  
  plaidItemId string | null
  
  institutionName string | null
  
  itemsCount number
  
  pendingOcApprovalCount number
  
  Set only for an Originating-org Lawyer on an OC-enabled case: count of items uploaded but not yet OC-approved for this source node. Omitted for OC callers and for OL callers on non-OC cases.
  
  backupStatus string | null
  
  Values are processing, completed, failed, or na.
  
  children array[object]
- statusCode number Required
- timestamp string(date-time) Required

GET /case/{caseId}/data-status-tree

curl \
 --request GET 'http://api.example.com/case/{caseId}/data-status-tree' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "organization: string"

Response examples (200)

{
  "data": {
    "data": [
      {
        "id": "507f1f77bcf86cd799439011",
        "kind": "financial",
        "sourceId": "65a1b2c3d4e5f6a7b8c9d0e2",
        "sourceName": "jane.doe@example.com",
        "plaidItemId": "65a1b2c3d4e5f6a7b8c9d0e2",
        "institutionName": "Example Bank",
        "itemsCount": 3,
        "pendingOcApprovalCount": 0,
        "backupStatus": "processing",
        "children": [
          {
            "name": "Messages",
            "count": 120,
            "subCount": 3
          }
        ]
      }
    ]
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}