List lists

get

https://api.delivr.ai/api/v1/lists

Retrieve lists with optional filtering. At least one of organization_id,
project_id, or integration_id is required.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

organization_id

uuid

Filter by organization ID (UUID).

project_id

uuid

Filter by project ID (UUID).

integration_id

uuid

Filter by integration ID (UUID).

type

string

Filter by type (comma-separated): hem, email, contact, account, domain, zipcode, phone, uid2, eid, ip, maid.

Unlike the type field on a list, the filter is a closed set: a value outside this list is refused rather than matching nothing, so a typo is answered instead of returning an empty page.

source

string

Filter by source (comma-separated): upload, csv_upload, import, manual, export, salesforce, hubspot, delivrdsp, delivrdsp_events, delivrdsp_uid2.

Closed set, as with type. Filter on the same spelling the response gives you; the values above are exactly what a list can report.

query

string

Search by list name (case-insensitive partial match).

limit

integer

≤ 1000

Defaults to 25

Maximum number of results to return (default 25, max 1000).

offset

integer

Defaults to 0

Number of results to skip (default 0).

sort_by

string

enum

Sort by field.

Allowed:

sort_order

string

enum

Defaults to desc

Sort order: asc or desc. Defaults to desc, so an unsorted request returns the newest lists first. Accepted with or without sort_by.

Allowed:

Responses

401

Missing or invalid authentication.

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200List of lists.

400Missing required filter parameter.