Skip to main content
GET
/
lead-lists
/
{id}
Retrieve Lead List
curl --request GET \
  --url https://api.amplemarket.com/lead-lists/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "object": "lead_list",
  "name": "<string>",
  "status": "queued",
  "shared": true,
  "visible": true,
  "owner": "[email protected]",
  "type": "linkedin",
  "leads": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "object": "lead_list_entry",
      "email": "[email protected]",
      "person_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "linkedin_url": "<string>",
      "linkedin": "<string>",
      "first_name": "<string>",
      "last_name": "<string>",
      "company_name": "<string>",
      "company_domain": "<string>",
      "industry": "<string>",
      "title": "<string>",
      "email_validation_result": {
        "object": "email_validation_result",
        "email": "[email protected]",
        "result": "deliverable",
        "catch_all": true
      },
      "data": {},
      "phone_numbers": [
        {
          "object": "phone_number",
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "number": "<string>",
          "type": "mobile",
          "source": "amplemarket"
        }
      ]
    }
  ],
  "_links": {
    "self": {
      "href": "<string>"
    },
    "prev": {
      "href": "<string>"
    },
    "next": {
      "href": "<string>"
    }
  },
  "created_at": "<string>",
  "updated_at": "<string>",
  "options": {
    "reveal_phone_numbers": true,
    "validate_email": true,
    "enrich": true
  },
  "_errors": [
    {
      "code": "<string>",
      "title": "<string>",
      "detail": "<string>",
      "source": {
        "pointer": "<string>"
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

Lead List id

Query Parameters

​
page[size]
string

Page size

​
page[after]
string

Page after

​
page[before]
string

Page before

Response

Successful

​
id
string<uuid>
required
​
object
enum<string>
required
Available options:
lead_list
​
name
string
required
​
status
enum<string>
required
Available options:
queued,
processing,
completed
​
shared
boolean
required
​
visible
boolean
required
​
owner
string<email>
required
​
type
enum<string>
required
Available options:
linkedin,
email,
title_and_company,
name_and_company,
salesforce,
hubspot,
person,
adaptive
​
leads
object[]
required
​
_links
object
required
​
created_at
string<date_time>
​
updated_at
string<date_time>
​
options
object
​
_errors
object[]