Skip to content
Docs

List Lead Finder List Items

Items in one list, with reveal status and lead link.

GET/api/v1/lead-finder/lists/{list_id}/items

Requires an API key with the read scope.

Path Parameters#

list_idstringpathrequired
The list id.

Query Parameters#

pageintegerquery
Page number, from 1.
pageSizeintegerquery
Items per page, 1 to 100. Default 50.

Response#

dataarray
Show Item
keystring
The item key (a person id or LinkedIn URL, or a company key).
snapshotobject
What was saved about the person or company.
addedAtstring
ISO 8601 timestamp.
revealStatusstring
found or pending once revealed, otherwise null.
revealedEmailstring
The revealed work email, or null.
inLeadsboolean
Whether the person is an active lead.
leadIdstring
The lead id when inLeads, otherwise null.
metaobject
page, pageSize, total and totalPages.

Errors#

StatusDescription
401Missing, invalid, revoked or expired API key
403API key does not have the required scope: read
404Lead Finder is not enabled while Lead Finder is switched off on this environment
503Lead Finder is not configured when it is enabled but has no data provider key
404List not found: the list does not exist in this workspace
422pageSize is outside 1 to 100

Rate Limit#

  • 300 requests per minute, shared by every read call in your workspace. Fixed 60-second window.
  • Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (unix epoch seconds) and X-RateLimit-Bucket (read).
  • A 429 response includes a Retry-After header (seconds until the bucket resets).

For client-side patterns, see Rate Limiting.

Was this page helpful?
View as MarkdownLast updated November 4, 2026