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

# Get lead

> Fetches details of a specific lead. Returns 404 if the lead has been deleted; use `GET /leads` to enumerate deleted leads (which surface with `deleted: true`) for incremental sync.



## OpenAPI

````yaml get /leads/{leadId}
openapi: 3.0.1
info:
  title: AttentPublicAPI
  version: '2024-05-17T21:09:13Z'
servers:
  - url: https://api.attent.app/v1
security: []
paths:
  /leads/{leadId}:
    get:
      description: >-
        Fetches details of a specific lead. Returns 404 if the lead has been
        deleted; use `GET /leads` to enumerate deleted leads (which surface with
        `deleted: true`) for incremental sync.
      parameters:
        - name: leadId
          in: path
          required: true
          schema:
            type: string
          description: The ID of the lead to fetch
      responses:
        '200':
          description: Lead details fetched successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: Stable unique identifier for the lead.
                  firstName:
                    type: string
                    description: The first name of the lead.
                  lastName:
                    type: string
                    description: The last name of the lead.
                  phone:
                    type: string
                    description: >-
                      The phone number of the lead. This will be in the format
                      `+15555555555`.
                  email:
                    type: string
                    description: The email address of the lead, if available.
                  customerProfile:
                    type: string
                    description: >-
                      The name of the customer profile to which this lead
                      belongs.
                  createdAt:
                    type: string
                    format: date-time
                    description: The date and time when the lead was created.
                  updatedAt:
                    type: string
                    format: date-time
                    description: >-
                      The date and time when the lead was last modified. Useful
                      for cache freshness checks.
                  additionalInfo:
                    type: object
                    description: >-
                      An optional key-value object containing additional
                      information stored with the lead. This includes any
                      context from when the lead was created, along with any
                      variables that Apten has stored for the lead.
                  hasReplied:
                    type: boolean
                    description: >-
                      Indicates whether the lead has replied to any messages
                      from Apten.
                  isHot:
                    type: boolean
                    description: Indicates whether the lead is considered "hot" by Apten.
                  isQualified:
                    type: boolean
                    description: >-
                      Indicates whether the lead is considered "qualified" by
                      Apten.
                  isUnsubscribed:
                    type: boolean
                    description: Indicates whether the lead has unsubscribed from Apten.
                  isAiOn:
                    type: boolean
                    description: Indicates whether Apten is turned on for the lead.
                  tags:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: The ID of the tag.
                        name:
                          type: string
                          description: The name of the tag.
                        condition:
                          type: string
                          description: The condition defined for the tag.
                    description: An array of tags associated with the lead.
                  summary:
                    type: string
                    description: A summary of the conversation with the lead.
                  externalLeadId:
                    type: string
                    description: >-
                      The ID of the lead in an external CRM (Salesforce,
                      HubSpot, Dynamics, or Close), if the lead is linked to
                      one.
                example:
                  id: room_abc
                  firstName: John
                  lastName: Doe
                  phone: '+15555555555'
                  email: john.doe@example.com
                  customerProfile: My Customer Profile
                  additionalInfo:
                    key1: value1
                    key2: value2
                  createdAt: '2024-05-17T21:09:13Z'
                  updatedAt: '2024-05-18T10:30:00Z'
                  hasReplied: true
                  isHot: true
                  isQualified: false
                  isUnsubscribed: false
                  isAiOn: true
                  tags:
                    - id: tag1
                      name: Tag 1
                      condition: Condition 1
                    - id: tag2
                      name: Tag 2
                      condition: Condition 2
                  summary: Summary of the conversation with the lead.
                  externalLeadId: 00Q5g00000ABCDEAA1
        '403':
          $ref: '#/components/responses/403'
        '404':
          description: Lead not found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                example:
                  message: Lead not found.
        '500':
          $ref: '#/components/responses/500'
      security:
        - api_key: []
components:
  responses:
    '403':
      description: Forbidden API key
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
            example:
              message: Forbidden
    '500':
      description: Internal Server Error
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
            example:
              message: Internal Server Error
  securitySchemes:
    api_key:
      type: apiKey
      name: x-api-key
      in: header

````