> ## Documentation Index
> Fetch the complete documentation index at: https://api.lawtte.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Scans call logs for a firm, uses AI to extract lead information (name, phone, email, case type), deduplicates, and creates Supabase lead records

> Scans call logs for a firm, uses AI to extract lead information (name, phone, email, case type), deduplicates, and creates Supabase lead records.



## OpenAPI

````yaml /api-reference/openapi.json post /api/leads/scan-calls
openapi: 3.1.0
info:
  title: Lawtte API
  version: v2
  description: >-
    REST API behind the Lawtte dashboard: AI voice and chat calls, agent
    configuration, leads, campaigns, contacts, and automation workflows.
  contact:
    name: Lawtte support
    email: contact@lawtte.ai
    url: https://www.lawtte.ai
servers:
  - url: https://www.lawtte.ai
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Voice & Chat
    description: Manage AI voice calls and chat sessions powered by Donna AI.
  - name: Agent Config
    description: Read and update AI agent prompts, voices, and configurations.
  - name: Appointments
    description: Check availability and book appointments via Cal.com integration.
  - name: Webhooks
    description: Receive real-time events after calls end.
  - name: Leads
    description: Create, manage, and analyze leads captured by your AI agents.
  - name: Campaigns
    description: Create and launch outbound call campaigns to lists of leads.
  - name: Contacts
    description: >-
      Import and sync contacts from CSV, OpenPhone, RingCentral, and practice
      management systems.
  - name: Workflows
    description: >-
      Build and manage automation workflows using a visual node-based flow
      editor.
  - name: Utilities
    description: Helper endpoints for AI-powered data extraction and widget testing.
paths:
  /api/leads/scan-calls:
    post:
      tags:
        - Leads
      summary: >-
        Scans call logs for a firm, uses AI to extract lead information (name,
        phone, email, case type), deduplicates, and creates Supabase lead
        records
      description: >-
        Scans call logs for a firm, uses AI to extract lead information (name,
        phone, email, case type), deduplicates, and creates Supabase lead
        records.
      operationId: post-leads-scan-calls
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - firmSlug
              properties:
                firmSlug:
                  type: string
                  description: Firm to scan calls for.
                limit:
                  type: number
                  description: Max calls to scan (default 50).
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
              example:
                created: 12
                duplicates: 3
                errors: 0
        '401':
          description: Missing or invalid credentials
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Lawtte API key or session token: `Authorization: Bearer <token>`.'

````

## Related topics

- [Creates a new lead record for a firm](/api-reference/leads/creates-a-new-lead-record-for-a-firm.md)
- [Initiates an outbound phone call from an AI agent to a specified phone number](/api-reference/voice-&-chat/initiates-an-outbound-phone-call-from-an-ai-agent-to-a-specified-phone-number.md)
- [Universal webhook handler for all firms](/api-reference/webhooks/universal-webhook-handler-for-all-firms.md)
- [Updates a lead record (status, notes, case type, etc.)](/api-reference/leads/updates-a-lead-record-status-notes-case-type-etc.md)
- [Creates a new outbound call campaign](/api-reference/campaigns/creates-a-new-outbound-call-campaign.md)