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

# Get Lead

> Retrieve complete lead information. Provide either `phone` or `lead_id` — not both.

- Use `phone` to look up a lead by phone number (useful for deduplication checks)
- Use `lead_id` when you already have the UUID from a previous API call




## OpenAPI

````yaml /api-reference/openapi.yaml get /lead/get
openapi: 3.0.3
info:
  title: Plura AI API
  description: >-
    Complete REST API reference for building powerful integrations with Plura
    AI.
  version: '1.7'
  contact:
    url: https://docs.plura.ai
servers:
  - url: https://api.plura.ai/v1
    description: Production
security:
  - bearerAuth: []
paths:
  /lead/get:
    get:
      tags:
        - Leads
      summary: Get Lead
      description: >
        Retrieve complete lead information. Provide either `phone` or `lead_id`
        — not both.


        - Use `phone` to look up a lead by phone number (useful for
        deduplication checks)

        - Use `lead_id` when you already have the UUID from a previous API call
      operationId: getLead
      parameters:
        - name: phone
          in: query
          required: false
          schema:
            type: string
          description: Phone number in E.164 format. Provide this OR lead_id.
          example: '17145551234'
        - name: lead_id
          in: query
          required: false
          schema:
            type: string
          description: Lead UUID. Provide this OR phone.
          example: 307fc241-8398-4740-8122-cf6a59f3b86e
      responses:
        '200':
          description: Lead found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Lead'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Lead not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                status: failed
                message: Lead not found
components:
  schemas:
    Lead:
      type: object
      properties:
        lead_id:
          type: string
          example: 307fc241-8398-4740-8122-cf6a59f3b86e
        phone:
          type: string
          example: '17145551234'
        first_name:
          type: string
          example: John
        last_name:
          type: string
          example: Smith
        email:
          type: string
          example: johnsmith@mail.com
        company:
          type: string
          example: Acme Corp
        tags:
          type: array
          items:
            type: string
          example:
            - High_Priority
            - New_Lead
        created_at:
          type: string
          format: date-time
          example: '2024-03-15T10:30:00Z'
        updated_at:
          type: string
          format: date-time
          example: '2024-03-15T14:22:00Z'
    Error:
      type: object
      properties:
        status:
          type: string
          example: failed
        message:
          type: string
          example: Human-readable error description
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key from Settings → API Keys in your workspace

````