# get_lead_recordings (/docs/mcp/tools/get-lead-recordings)

{/* Generated by scripts/sync-mcp-tools.mjs from happierleads-api. Do not edit: change src/routes/mcp/toolDocs.json there, or add content/mcp-notes/get_lead_recordings.mdx. */}

**List session recordings** · Read-only

List session recordings (replays of what a visitor did on your website), newest first, up to 100. Pass clientId to list a website's recordings, or email to list one identified visitor's recordings. Each recording has session_id, client_id, lead_email, started_at, ended_at, duration_ms, page_count, first_page and finalized. Recordings exist only when session recording is enabled for the website. clientId comes from get_website or get_tracking_pixel; the email is the lead's exactPerson email from get_leads. To watch one, pass its session_id and client_id to get_recording_url. At least one of clientId or email is required. Read-only.

| Connection | Account URL, team member URL or OAuth |
| --- | --- |

## Parameters [#parameters]

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `clientId` | `string` | No | The website's clientId (16-32 characters) from get_website or get_tracking_pixel. |
| `email` | `string` | No | Email address of an identified visitor (from get_leads). When given, the list is the recordings for this email. |

## Tool definition [#tool-definition]

What your assistant receives from `tools/list`:

```json
{
  "name": "get_lead_recordings",
  "title": "List session recordings",
  "annotations": {
    "title": "List session recordings",
    "readOnlyHint": true,
    "destructiveHint": false,
    "idempotentHint": true,
    "openWorldHint": false
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "clientId": {
        "type": "string",
        "description": "The website's clientId (16-32 characters) from get_website or get_tracking_pixel."
      },
      "email": {
        "type": "string",
        "description": "Email address of an identified visitor (from get_leads). When given, the list is the recordings for this email."
      }
    }
  }
}
```