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

# Retrieve Lead List

> Retrieve Lead List



## OpenAPI

````yaml get /lead-lists/{id}
openapi: 3.0.1
info:
  title: Amplemarket API V1 Docs
  version: v1
servers:
  - url: https://api.amplemarket.com
security:
  - bearerAuth: []
paths:
  /lead-lists/{id}:
    get:
      tags:
        - Lead List
      summary: Retrieve Lead List
      description: Retrieve Lead List
      parameters:
        - name: id
          in: path
          required: true
          description: Lead List id
          schema:
            type: string
        - name: page[size]
          in: query
          required: false
          description: Page size
          schema:
            type: string
        - name: page[after]
          in: query
          required: false
          description: Page after
          schema:
            type: string
        - name: page[before]
          in: query
          required: false
          description: Page before
          schema:
            type: string
      responses:
        '200':
          description: Successful
          content:
            application/json:
              examples:
                Processing:
                  value:
                    id: 019e8e97-39d2-71b8-9560-04f0823cad28
                    object: lead_list
                    name: my list
                    status: processing
                    url: >-
                      https://localhost:3000/dashboard/lead_lists/019e8e97-39d2-71b8-9560-04f0823cad28
                    shared: true
                    visible: false
                    owner: admin@example.com
                    type: linkedin
                    created_at: '2026-06-03T17:45:35Z'
                    updated_at: '2026-06-03T17:45:35Z'
                    options:
                      reveal_phone_numbers: true
                      validate_email: true
                      enrich: true
                    leads: []
                    _links:
                      self:
                        href: /lead-lists/019e8e97-39d2-71b8-9560-04f0823cad28
                Completed:
                  value:
                    id: 019e8e97-3a51-72da-a318-bc087e5482b4
                    object: lead_list
                    name: my list
                    status: completed
                    url: >-
                      https://localhost:3000/dashboard/lead_lists/019e8e97-3a51-72da-a318-bc087e5482b4
                    shared: true
                    visible: false
                    owner: admin@example.com
                    type: linkedin
                    created_at: '2026-06-03T17:45:36Z'
                    updated_at: '2026-06-03T17:45:36Z'
                    options:
                      reveal_phone_numbers: true
                      validate_email: true
                      enrich: true
                    leads:
                      - id: 4ba3394f-b0f2-44e0-86e0-f360a0a8dcec
                        object: lead_list_entry
                        email: john_smith@example.com
                        person_id: 019e8e97-3a46-7bb9-89fb-ffecca44b494
                        linkedin_url: https://www.linkedin.com/in/john-smith
                        linkedin: https://www.linkedin.com/in/john-smith
                        first_name: John
                        last_name: Smith
                        company_name: Example, Inc
                        company_domain: example.com
                        industry: Computer Software
                        title: CEO
                        email_validation_result:
                          object: email_validation_result
                          email: john_smith@example.com
                          result: undeliverable
                        data:
                          example_data_field: '1'
                        phone_numbers:
                          - id: 019e8e97-3b19-733c-9543-d8f8a89adc96
                            object: phone_number
                            number: +1 639-300-0001
                            type: mobile
                            source: amplemarket
                          - id: 019e8e97-3b2e-7131-a64d-f8324949dd65
                            object: phone_number
                            number: +1 639-300-0002
                            type: mobile
                            source: amplemarket
                      - id: 5ba3394f-b0f2-44e0-86e0-f360a0a8dcec
                        object: lead_list_entry
                        email: jane_smith@example.com
                        person_id: 019e8e97-3b63-73f6-9682-0ec3b3a4959e
                        linkedin_url: https://www.linkedin.com/in/jane-smith
                        linkedin: https://www.linkedin.com/in/jane-smith
                        first_name: Jane
                        last_name: Smith
                        company_name: Example, Inc
                        company_domain: example.com
                        industry: Computer Software
                        title: CFO
                        email_validation_result:
                          object: email_validation_result
                          email: jane_smith@example.com
                          result: risky
                        data:
                          example_data_field: '2'
                        phone_numbers: []
                      - id: 6ba3394f-b0f2-44e0-86e0-f360a0a8dcec
                        object: lead_list_entry
                        email: jim_smith@example.com
                        person_id: 019e8e97-3b74-7dc8-8724-5ae570702a63
                        linkedin_url: https://www.linkedin.com/in/jim-smith
                        linkedin: https://www.linkedin.com/in/jim-smith
                        first_name: Jim
                        last_name: Smith
                        company_name: Example, Inc
                        company_domain: example.com
                        industry: Computer Software
                        title: CTO
                        email_validation_result:
                          object: email_validation_result
                          email: jim_smith@example.com
                          result: risky
                        data:
                          example_data_field: '3'
                        phone_numbers: []
                    _links:
                      self:
                        href: /lead-lists/019e8e97-3a51-72da-a318-bc087e5482b4
                Completed (Pagination using after):
                  value:
                    id: 019e8e97-3c5d-72c6-9e4a-db9729c7d8af
                    object: lead_list
                    name: my list
                    status: completed
                    url: >-
                      https://localhost:3000/dashboard/lead_lists/019e8e97-3c5d-72c6-9e4a-db9729c7d8af
                    shared: true
                    visible: false
                    owner: admin@example.com
                    type: linkedin
                    created_at: '2026-06-03T17:45:36Z'
                    updated_at: '2026-06-03T17:45:36Z'
                    options:
                      reveal_phone_numbers: true
                      validate_email: true
                      enrich: true
                    leads:
                      - id: 5ba3394f-b0f2-44e0-86e0-f360a0a8dcec
                        object: lead_list_entry
                        email: jane_smith@example.com
                        person_id: 019e8e97-3c80-7c7c-937d-c292a3986178
                        linkedin_url: https://www.linkedin.com/in/jane-smith
                        linkedin: https://www.linkedin.com/in/jane-smith
                        first_name: Jane
                        last_name: Smith
                        company_name: Example, Inc
                        company_domain: example.com
                        industry: Computer Software
                        title: CFO
                        email_validation_result:
                          object: email_validation_result
                          email: jane_smith@example.com
                          result: risky
                        data:
                          example_data_field: '2'
                        phone_numbers: []
                    _links:
                      self:
                        href: /lead-lists/019e8e97-3c5d-72c6-9e4a-db9729c7d8af
                      prev:
                        href: >-
                          /lead-lists/019e8e97-3c5d-72c6-9e4a-db9729c7d8af?page[size]=1&page[before]=5ba3394f-b0f2-44e0-86e0-f360a0a8dcec
                      next:
                        href: >-
                          /lead-lists/019e8e97-3c5d-72c6-9e4a-db9729c7d8af?page[size]=1&page[after]=5ba3394f-b0f2-44e0-86e0-f360a0a8dcec
                Completed (Pagination using before):
                  value:
                    id: 019e8e97-3d2d-7dc5-b5a4-c3f743f053df
                    object: lead_list
                    name: my list
                    status: completed
                    url: >-
                      https://localhost:3000/dashboard/lead_lists/019e8e97-3d2d-7dc5-b5a4-c3f743f053df
                    shared: true
                    visible: false
                    owner: admin@example.com
                    type: linkedin
                    created_at: '2026-06-03T17:45:36Z'
                    updated_at: '2026-06-03T17:45:36Z'
                    options:
                      reveal_phone_numbers: true
                      validate_email: true
                      enrich: true
                    leads:
                      - id: 5ba3394f-b0f2-44e0-86e0-f360a0a8dcec
                        object: lead_list_entry
                        email: jane_smith@example.com
                        person_id: 019e8e97-3d58-7197-9c99-45745e464eeb
                        linkedin_url: https://www.linkedin.com/in/jane-smith
                        linkedin: https://www.linkedin.com/in/jane-smith
                        first_name: Jane
                        last_name: Smith
                        company_name: Example, Inc
                        company_domain: example.com
                        industry: Computer Software
                        title: CFO
                        email_validation_result:
                          object: email_validation_result
                          email: jane_smith@example.com
                          result: risky
                        data:
                          example_data_field: '2'
                        phone_numbers: []
                    _links:
                      self:
                        href: /lead-lists/019e8e97-3d2d-7dc5-b5a4-c3f743f053df
                      prev:
                        href: >-
                          /lead-lists/019e8e97-3d2d-7dc5-b5a4-c3f743f053df?page[size]=1&page[before]=5ba3394f-b0f2-44e0-86e0-f360a0a8dcec
                      next:
                        href: >-
                          /lead-lists/019e8e97-3d2d-7dc5-b5a4-c3f743f053df?page[size]=1&page[after]=5ba3394f-b0f2-44e0-86e0-f360a0a8dcec
              schema:
                $ref: '#/components/schemas/response_lead_list_object'
        '404':
          description: Not found
          content:
            application/json:
              examples:
                Not found:
                  value:
                    _errors:
                      - code: not_found
                        title: Not Found
                        detail: Could not find lead list.
                    object: error
              schema:
                $ref: '#/components/schemas/response_errors_object'
        '410':
          description: Gone
          content:
            application/json:
              examples:
                Gone:
                  value:
                    _errors:
                      - code: gone
                        title: Gone
                        detail: Lead list is no longer available.
                    object: error
              schema:
                $ref: '#/components/schemas/response_errors_object'
        '500':
          description: Internal server error
          content:
            application/json:
              examples:
                Internal server error:
                  value:
                    _errors:
                      - code: internal_server_error
                        title: Internal Server Error
                        detail: Something went wrong.
                    object: error
              schema:
                $ref: '#/components/schemas/response_errors_object'
components:
  schemas:
    response_lead_list_object:
      type: object
      required:
        - id
        - object
        - name
        - status
        - url
        - shared
        - visible
        - owner
        - type
        - leads
        - _links
      additionalProperties: false
      properties:
        id:
          type: string
          format: uuid
        object:
          type: string
          enum:
            - lead_list
        name:
          type: string
        status:
          type: string
          enum:
            - queued
            - processing
            - completed
        url:
          type: string
        shared:
          type: boolean
        visible:
          type: boolean
        owner:
          type: string
          format: email
        type:
          type: string
          enum:
            - linkedin
            - email
            - title_and_company
            - name_and_company
            - salesforce
            - hubspot
            - person
            - adaptive
        created_at:
          type: string
          format: date_time
        updated_at:
          type: string
          format: date_time
        options:
          type: object
          required:
            - reveal_phone_numbers
            - validate_email
            - enrich
          additionalProperties: false
          properties:
            reveal_phone_numbers:
              type: boolean
            validate_email:
              type: boolean
            enrich:
              type: boolean
        leads:
          type: array
          items:
            $ref: '#/components/schemas/response_lead_list_entry_object'
        _errors:
          type: array
          items:
            $ref: '#/components/schemas/response_error_object'
        _links:
          $ref: '#/components/schemas/response_links_object'
    response_errors_object:
      type: object
      required:
        - object
        - _errors
      additionalProperties: false
      properties:
        object:
          type: string
          enum:
            - error
        _errors:
          type: array
          items:
            $ref: '#/components/schemas/response_error_object'
        _links:
          $ref: '#/components/schemas/response_links_object'
    response_lead_list_entry_object:
      type: object
      required:
        - id
        - object
        - email
        - person_id
        - linkedin_url
        - linkedin
        - first_name
        - last_name
        - company_name
        - company_domain
        - industry
        - title
        - email_validation_result
        - data
      additionalProperties: false
      properties:
        id:
          type: string
          format: uuid
        object:
          type: string
          enum:
            - lead_list_entry
        email:
          type: string
          format: email
        person_id:
          type: string
          format: uuid
        linkedin_url:
          type: string
        linkedin:
          type: string
        first_name:
          type: string
        last_name:
          type: string
        company_name:
          type: string
        company_domain:
          type: string
        industry:
          type: string
        title:
          type: string
        email_validation_result:
          $ref: >-
            #/components/schemas/response_lead_list_entry_email_validation_result_object
        data:
          type: object
          additionalProperties: true
        phone_numbers:
          type: array
          items:
            $ref: '#/components/schemas/response_phone_number_object'
    response_error_object:
      type: object
      required:
        - code
        - title
        - detail
      additionalProperties: false
      properties:
        code:
          type: string
        title:
          type: string
        detail:
          type: string
        source:
          type: object
          additionalProperties: false
          properties:
            pointer:
              type: string
    response_links_object:
      type: object
      required:
        - self
      additionalProperties: false
      properties:
        self:
          $ref: '#/components/schemas/response_link_object'
        prev:
          $ref: '#/components/schemas/response_link_object'
        next:
          $ref: '#/components/schemas/response_link_object'
    response_lead_list_entry_email_validation_result_object:
      type: object
      required:
        - object
        - email
        - result
      additionalProperties: false
      properties:
        object:
          type: string
          enum:
            - email_validation_result
        email:
          type: string
          format: email
        result:
          type: string
          enum:
            - deliverable
            - risky
            - undeliverable
            - unknown
    response_phone_number_object:
      type: object
      required:
        - object
        - id
        - number
        - type
      additionalProperties: true
      properties:
        object:
          type: string
          enum:
            - phone_number
        id:
          type: string
          format: uuid
        number:
          type: string
        type:
          type: string
          enum:
            - mobile
            - office
            - phone
            - landline
            - voip
            - direct
        source:
          type: string
          enum:
            - amplemarket
            - crm
            - user_uploaded
    response_link_object:
      type: object
      required:
        - href
      additionalProperties: false
      properties:
        href:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````