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

# Detalhes do Lead

> Retorna os dados completos de um lead específico pelo seu ID.



## OpenAPI

````yaml GET /v1/leads/{id}
openapi: 3.0.1
info:
  title: Integrabot API
  version: 1.0.0
  description: >-
    A API do Integrabot permite gerenciar leads, agents e integrações de forma
    programática. Use esta API para criar leads a partir de formulários web,
    sincronizar contatos com seu CRM ou automatizar fluxos de trabalho com os
    agents de IA do Integrabot.
  contact:
    name: Suporte Integrabot
    email: hello@integrabot.ai
    url: https://docs.integrabot.ai
servers:
  - url: https://api.integrabot.ai
    description: Produção
security:
  - bearerAuth: []
paths:
  /v1/leads/{id}:
    get:
      tags:
        - Leads
      summary: Detalhes do Lead
      description: Retorna os dados completos de um lead específico pelo seu ID.
      operationId: getLead
      parameters:
        - name: id
          in: path
          required: true
          description: ID numérico do lead.
          schema:
            type: integer
      responses:
        '200':
          description: Dados do lead.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Lead'
              example:
                id: 1234
                name: Maria Silva
                type: web
                phone_number: '5511999998888'
                email: maria@exemplo.com
                status: new
                agent_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                custom_fields:
                  empresa: Acme Ltda
                  cidade: São Paulo
                created_at: '2025-01-15T10:30:00Z'
                updated_at: '2025-01-15T14:22:00Z'
        '401':
          description: Token de API inválido ou ausente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorUnauthorized'
        '404':
          description: Lead não encontrado.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorNotFound'
components:
  schemas:
    Lead:
      type: object
      properties:
        id:
          type: integer
          example: 1234
        name:
          type: string
          example: Maria Silva
        type:
          type: string
          enum:
            - web
            - telegram
            - email
            - manual
          example: web
        phone_number:
          type: string
          nullable: true
          example: '5511999998888'
        email:
          type: string
          nullable: true
          example: maria@exemplo.com
        status:
          type: string
          enum:
            - new
            - contacted
            - qualified
            - lost
            - converted
          example: new
        agent_id:
          type: string
          format: uuid
          nullable: true
          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
        custom_fields:
          type: object
          nullable: true
          additionalProperties:
            type: string
          example:
            empresa: Acme Ltda
            cidade: São Paulo
        created_at:
          type: string
          format: date-time
          example: '2025-01-15T10:30:00Z'
        updated_at:
          type: string
          format: date-time
          example: '2025-01-15T14:22:00Z'
    ErrorUnauthorized:
      type: object
      properties:
        error:
          type: string
          example: Unauthorized
        message:
          type: string
          example: Token de API inválido ou ausente.
    ErrorNotFound:
      type: object
      properties:
        error:
          type: string
          example: Not Found
        message:
          type: string
          example: Recurso não encontrado.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key starting with sk_

````