> ## 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.

# List Lead Types

> Returns the lead categories you can assign when creating or updating leads. Use this endpoint to discover the available lead_type IDs and the metadata fields each lead type accepts, so new leads can be routed and handled correctly.



## OpenAPI

````yaml /Sela_API.yaml get /api/lead-types/
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/:
    get:
      tags:
        - Lead Types
      summary: List Lead Types
      description: >-
        Returns the lead categories you can assign when creating or updating
        leads. Use this endpoint to discover the available lead_type IDs and the
        metadata fields each lead type accepts, so new leads can be routed and
        handled correctly.
      operationId: lead_types_list
      parameters:
        - name: page
          required: false
          in: query
          description: A page number within the paginated result set.
          schema:
            type: integer
        - name: page_size
          required: false
          in: query
          description: Number of results to return per page.
          schema:
            type: integer
        - in: query
          name: search
          schema:
            type: string
          description: Case-insensitive search over lead type name.
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedLeadTypeReadList'
              examples:
                ListOfLeadTypes:
                  value:
                    count: 123
                    next: http://api.example.org/accounts/?page=4
                    previous: http://api.example.org/accounts/?page=2
                    results:
                      - count: 2
                        next: null
                        previous: null
                        results:
                          - 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: List of lead types
          description: Paginated list of lead types.
      security:
        - tokenAuth: []
components:
  schemas:
    PaginatedLeadTypeReadList:
      type: object
      required:
        - count
        - results
      properties:
        count:
          type: integer
          example: 123
        next:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?page=4
        previous:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?page=2
        results:
          type: array
          items:
            $ref: '#/components/schemas/LeadTypeRead'
    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"

````