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": "019a01e3-2013-78b2-82c4-04c60168b5fb",
  "object": "lead_list",
  "name": "my list",
  "status": "processing",
  "shared": true,
  "visible": false,
  "owner": "admin@example.com",
  "type": "linkedin",
  "created_at": "2025-10-20T13:50:53Z",
  "updated_at": "2025-10-20T13:50:53Z",
  "options": {
    "reveal_phone_numbers": true,
    "validate_email": true,
    "enrich": true
  },
  "leads": [],
  "_links": {
    "self": {
      "href": "/lead-lists/019a01e3-2013-78b2-82c4-04c60168b5fb"
    }
  }
}

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[]