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

# Retrieve a Lead Type

> Returns details for one lead type, including the metadata fields accepted for leads in that category. Use this before creating leads when you need to confirm which metadata keys and value types to send.



## OpenAPI

````yaml /Sela_API.yaml get /api/lead-types/{id}/
openapi: 3.0.3
info:
  title: Sela API
  version: 1.0.2
  description: Voice AI agents with superhuman conversion rates
servers:
  - url: https://api.trysela.com/
    description: Production API
security: []
paths:
  /api/lead-types/{id}/:
    get:
      tags:
        - Lead Types
      summary: Retrieve a Lead Type
      description: >-
        Returns details for one lead type, including the metadata fields
        accepted for leads in that category. Use this before creating leads when
        you need to confirm which metadata keys and value types to send.
      operationId: lead_types_retrieve
      parameters:
        - in: path
          name: id
          schema:
            type: integer
          description: A unique integer value identifying this lead type.
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LeadTypeRead'
              examples:
                LeadTypeRetrieved:
                  value:
                    id: 123
                    name: Refinance
                    lead_metadata_fields:
                      - key: first_name
                        label: First Name
                        helpText: The lead's first name
                        type: string
                        required: true
                      - key: loan_amount
                        label: Loan Amount
                        helpText: Requested loan amount
                        type: number
                        required: false
                  summary: Lead type retrieved
          description: Lead type retrieved successfully.
        '404':
          description: Lead type not found or not accessible.
      security:
        - tokenAuth: []
components:
  schemas:
    LeadTypeRead:
      type: object
      description: Read-only lead type details.
      properties:
        id:
          type: integer
          readOnly: true
          description: >-
            Unique identifier for this lead type. Use this value as the
            lead_type when creating or updating leads.
        name:
          type: string
          readOnly: true
          description: >-
            Customer-facing name of the lead type, such as a campaign, product,
            or intake flow.
        lead_metadata_fields:
          type: array
          items:
            $ref: '#/components/schemas/LeadMetadataFieldNested'
          readOnly: true
          description: >-
            Metadata fields accepted for leads with this lead type. Each field
            describes the key to send in lead metadata, its display label,
            expected value type, and whether it is required.
      required:
        - id
        - lead_metadata_fields
        - name
    LeadMetadataFieldNested:
      type: object
      description: Metadata field accepted for a lead type.
      properties:
        key:
          type: string
          maxLength: 127
        label:
          type: string
          maxLength: 127
        helpText:
          type: string
          nullable: true
          maxLength: 255
        type:
          $ref: '#/components/schemas/TypeEnum'
        required:
          type: boolean
      required:
        - key
        - label
    TypeEnum:
      enum:
        - string
        - text
        - integer
        - number
        - boolean
        - datetime
      type: string
      description: |-
        * `string` - String
        * `text` - Text
        * `integer` - Integer
        * `number` - Number
        * `boolean` - Boolean
        * `datetime` - DateTime
  securitySchemes:
    tokenAuth:
      type: apiKey
      in: header
      name: Authorization
      description: Token-based authentication with required prefix "Token"

````