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

# Preview lead list API

> Page through a finished list's rows with sorting and search. Returns every stored column plus crawl-sourced contact data. Free.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Does the preview show everything the export contains?">
    Yes. The preview returns all 14 stored company columns plus the `web` block with crawl-sourced emails, phones, social profile URLs and site language — deliberately identical to what the export ships, so what you see is what you download.
  </Accordion>

  <Accordion title="Why are founded, industry_code and associated_members sometimes zero?">
    Zero is the stored 'unknown' default for those numeric columns, not a real value. Treat `0` as missing.
  </Accordion>

  <Accordion title="Why is the web block null on some rows?">
    That domain has no crawled contact record. Contact enrichment is fail-open — a missing record yields `web: null` rather than dropping the row or failing the request.
  </Accordion>

  <Accordion title="How do I resolve the technology ids?">
    Fetch [the technology map](/docs/api-reference/lead-lists/technology-map-api) once and resolve locally. Exports resolve names server-side, so they need no lookup.
  </Accordion>
</AccordionGroup>


## OpenAPI

````yaml GET /v1/leads/lists/{id}/preview
openapi: 3.1.0
info:
  title: TechnologyChecker API
  description: >-
    Discover technology stacks, track market trends, and enrich data with
    company intelligence.
  version: 1.0.0
  contact:
    name: TechnologyChecker Support
    email: support@technologychecker.io
    url: https://technologychecker.io
servers:
  - url: https://api.technologychecker.io
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Domain technologies
    description: Look up technologies detected on any domain
  - name: Technology data
    description: Search, look up, and get details on tracked technologies
  - name: Market intelligence
    description: Technology stats, trends, and market share
  - name: Company data
    description: Firmographic and company intelligence
  - name: Live detection
    description: Real-time technology detection with browser rendering
  - name: Signals
    description: >-
      Intent signals derived from technology state transitions: who adopted, who
      churned, who switched, and who has a gap in their stack.
  - name: Alerts
    description: >-
      Saved signal queries delivered to your webhook. Every signal you can
      query, you can subscribe to.
  - name: Audiences
    description: >-
      Saved groups of domains — uploaded lists or computed recipes — that you
      can profile, slice and monitor.
  - name: Lead lists
    description: >-
      Build and export targeted domain lists combining technology detection with
      company data.
paths:
  /v1/leads/lists/{id}/preview:
    get:
      tags:
        - Lead lists
      summary: Preview lead list API
      description: >-
        Page through a finished list's rows with sorting and search. The preview
        returns **everything the list holds** — all 14 stored company columns
        plus the crawl-sourced `web` block — so what you see here is exactly
        what the export ships. Free.
      operationId: previewLeadList
      parameters:
        - name: id
          in: path
          required: true
          description: The lead list id.
          schema:
            type: string
            format: uuid
            example: f6ab2d94-c34f-47b7-9d1a-228e71488cd2
        - name: limit
          in: query
          required: false
          description: Rows per page. Capped at 100.
          schema:
            type: integer
            default: 50
            maximum: 100
        - name: offset
          in: query
          required: false
          description: Pagination offset.
          schema:
            type: integer
            default: 0
        - name: sort_by
          in: query
          required: false
          description: Column to sort by.
          schema:
            type: string
            enum:
              - domain
              - company_name
              - country
              - industry
              - employees
        - name: sort_order
          in: query
          required: false
          description: Sort direction.
          schema:
            type: string
            enum:
              - asc
              - desc
            default: asc
        - name: search
          in: query
          required: false
          description: Filter rows by domain or company name.
          schema:
            type: string
      responses:
        '200':
          description: A page of list rows
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      results:
                        type: array
                        items:
                          $ref: '#/components/schemas/LeadListRow'
                      total:
                        type: integer
                        example: 1000
                      limit:
                        type: integer
                        example: 50
                      offset:
                        type: integer
                        example: 0
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
components:
  schemas:
    LeadListRow:
      type: object
      properties:
        domain:
          type: string
          example: example.com
        detection_url:
          type: string
          example: EXAMPLE.COM
        technology_ids:
          type: array
          items:
            type: integer
          example:
            - 2
        company_name:
          type: string
          example: Example Corp
        linkedin_url:
          type: string
          example: linkedin.com/company/example
        industry:
          type: string
          example: Software Development
        industry_code:
          type: integer
          description: '`0` means unknown.'
          example: 4
        country:
          type: string
          example: United States
        city:
          type: string
          example: Austin
        state:
          type: string
          example: Texas
        founded:
          type: integer
          description: '`0` means unknown.'
          example: 2015
        employees:
          type: string
          example: 51-200
        company_type:
          type: string
          example: Privately Held
        associated_members:
          type: integer
          description: '`0` means unknown.'
          example: 42
        web:
          type: object
          nullable: true
          description: >-
            Crawl-sourced contact data, matching what the export ships. `null`
            when the domain has no crawled row.
          properties:
            emails:
              type: array
              items:
                type: string
              example:
                - hi@example.com
            phones:
              type: array
              items:
                type: string
              example:
                - +1 555 0100
            socials:
              type: object
              additionalProperties:
                type: string
              description: Only the platforms that domain publishes, as full profile URLs.
              example:
                linkedin: https://www.linkedin.com/company/example
            language:
              type: string
              example: en
    ApiError:
      type: object
      properties:
        success:
          type: boolean
          example: false
        error:
          type: object
          properties:
            code:
              type: string
              example: UNAUTHORIZED
            message:
              type: string
              example: Missing or invalid API key
  responses:
    BadRequest:
      description: Invalid or missing parameters
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
          example:
            success: false
            error:
              code: VALIDATION_ERROR
              message: >-
                Provide exactly one scope: technology_id, technology or
                category_id.
    Unauthorized:
      description: Missing or invalid API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
    RateLimited:
      description: Rate limit exceeded
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiError'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        API key in format `tapi_live_[32-char]` (live) or `tapi_test_[32-char]`
        (test)

````