integrations

List the matter participants of a case

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

mcp.json 
{
  "integrations MCP server": {
    "url": "https://docs.usehearsay.com/mcp"
  }
}
Close
GET /legal/cases/{caseId}/participants
Access token

Lists the people imported from the Clio or Smokeball matters linked to the case (attorneys and contacts) with name, email, phone, role, whether they are a custodian and their provider id; the optional provider query narrows to one provider. Empty when the case is not linked. Requires a member role or above in the organization.

Headers

  • organization string Required

    id of the selected (active) organization

Path parameters

  • caseId string Required

Query parameters

  • provider string Required

Responses

  • 200 application/json
    Hide response attributes Show response attributes object
    • data object Required
      Hide data attribute Show data attribute object
      • participants array[object]
        Hide participants attributes Show participants attributes object
        • _id string
        • organizationId string
        • caseId string
        • caseIntegrationId string
        • provider string
        • firstName string
        • lastName string
        • email string
        • phone string
        • role string

          Values are client, witness, opposing_party, other, or attorney.

        • isCustodian boolean
        • externalId string
        • hearsayUserId string
        • extractionCodeId string
        • createdAt string(date-time)
        • updatedAt string(date-time)
    • statusCode number Required
    • timestamp string(date-time) Required
GET /legal/cases/{caseId}/participants 
curl \
 --request GET 'http://api.example.com/legal/cases/{caseId}/participants?provider=string' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "organization: string"
Response examples (200) 
{
  "data": {
    "participants": [
      {
        "_id": "65a1b2c3d4e5f6a7b8c9d0e7",
        "organizationId": "65a1b2c3d4e5f6a7b8c9d0e3",
        "caseId": "65a1b2c3d4e5f6a7b8c9d0e2",
        "caseIntegrationId": "65a1b2c3d4e5f6a7b8c9d0e8",
        "provider": "clio",
        "firstName": "Jane",
        "lastName": "Doe",
        "email": "jane.doe@example.com",
        "phone": "+15555550123",
        "role": "attorney",
        "isCustodian": false,
        "externalId": "987654",
        "hearsayUserId": "65a1b2c3d4e5f6a7b8c9d0e4",
        "extractionCodeId": "string",
        "createdAt": "2026-01-15T10:15:00.000Z",
        "updatedAt": "2026-01-15T10:15:00.000Z"
      }
    ]
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}