Skip to main content
get list results
The assistant tool is get_list_results. Read one list export that belongs to the authenticated account. Send export_id only. A job token or account ID is not accepted. Another account’s export is export_not_found. pending keeps the credit reservation. ready returns record_ids, returned_count and additional_matches. The first successful delivery settles 1 credit per 100 returned IDs, rounded up. A later read of the same export costs zero and keeps the original receipt. empty and failed release the reservation and return no IDs. Read failure for a failed list. lookup_rejected is the same outcome as the deprecated failure_code value provider_rejected. Other failure codes match failure. A lookup timeout while the export is still pending does not release the reservation; retry this call. Enriching a returned ID with get_person_profile or get_company_profile uses the existing profile price. The job token is discarded when the export completes or fails. Record IDs remain for 7 days after completion. After that, a read still returns returned_count with ids_available: false and an empty record_ids list. That later read stays free.

Authorizations

Authorization
string
header
required

Send Authorization: Bearer dl_live_<64 lowercase hexadecimal characters>. Signed-in users can create account-scoped, revocable keys in the Datalayer dashboard. A key does not grant credits. Dashboard session cookies are not API credentials.

Headers

Idempotency-Key
string

Recommended for every paid operation. Account-scoped and bound to normalized operation/input. Retry exactly the same key after transport loss: a committed credit result is replayed from persisted normalized bytes without a data lookup or another debit. Changed input, key expiry or paid-anchor expiry returns 409. In-flight requests return request_in_progress. Network delivery and D1 commit are not atomic. If omitted a request ID is created.

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9_-]{1,128}$

Body

application/json
export_id
string<uuid>
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Response

A settled result or a maximum estimate with no data lookup.

data
object
required
meta
object
required