Skip to main content
GET
List lead lists API

Frequently asked questions

processing — the background job is still running. ready — rows are available to preview and export. failed — the job errored and nothing was charged. expired — the list passed its 60-day retention and its rows were deleted.
No, the rows are gone. The list metadata including its filters is retained, so you can rebuild it with the same criteria — that costs credits again, and results will reflect current data.

Authorizations

Authorization
string
header
required

API key in format tapi_live_[32-char] (live) or tapi_test_[32-char] (test)

Query Parameters

status
enum<string>

Filter by status.

Available options:
processing,
ready,
failed,
expired
limit
integer
default:20

Results per page. Capped at 100.

Required range: x <= 100
offset
integer
default:0

Pagination offset.

Response

Your lead lists

success
boolean
Example:

true

data
object