Skip to main content
get list filters
The assistant tool is get_list_filters. Discover feature IDs for a person or company list. A feature ID is a filter value, not a person or company profile ID. Person feature types are company, job_title, industry, country, company_type, language_prof, job_title_tag and linkedin_school. Company feature types are industry, company_type and employee_size. employee_size requires code A through I. company_type codes are G, S, P, D, E, N, C and O. tag_type applies to job_title_tag. modifiers (past, present, ever) apply to person company features. Later list tools combine feature IDs with comma for AND, | for OR, ~ for NOT, and parentheses. An expression can contain at most 530 feature IDs. This call costs zero credits. limit defaults to 25 and cannot exceed 100. dry_run returns an estimate without a lookup. An active credit allowance is required.

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
entity
enum<string>
required
Available options:
person,
company
type
enum<string>
required
Available options:
company,
job_title,
industry,
country,
company_type,
language_prof,
job_title_tag,
linkedin_school,
employee_size
limit
integer
default:25

Advanced: how many filters to return, from 1 to 100. Defaults to 25.

Required range: 1 <= x <= 100
Required string length: 1 - 8000
code
string
Required string length: 1 - 8
company_id
string
Pattern: ^[1-9][0-9]{0,19}$
url
string
Required string length: 1 - 2000
org_id
string
Pattern: ^[1-9][0-9]{0,19}$
linkedin_url
string
Required string length: 1 - 2000
concat_features
boolean
tag_type
enum<string>
Available options:
job_seniority,
job_function,
job_employment_type,
job_academic_qualification
modifiers
string
Pattern: ^(?:past|present|ever)(?:,(?:past|present|ever)){0,2}$
dry_run
boolean

Advanced: return the maximum credit estimate without looking up data.

Response

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

data
object
required
meta
object
required