Skip to main content
GET
Get a contact list

Authorizations

Authorization
string
header
required

Workspace API key, e.g. Authorization: Bearer tented_.... Create keys in Workspace Settings → API Keys.

Path Parameters

listId
string<uuid>
required

Contact list ID.

Response

The contact list.

list_id
string<uuid>
required

Contact list ID.

name
string
required

List name. Unique within the workspace.

kind
enum<string>
required

static = membership managed manually via the member endpoints; dynamic = membership computed continuously from rules; system = auto-managed by the platform (read-only). Immutable after creation.

Available options:
static,
dynamic,
system
created_at
string<date-time>
required

Creation time.

updated_at
string<date-time>
required

Last update.

slug
string | null

URL-safe identifier derived from the name.

description
string | null

Optional description.

rules
object | null

Segment rule tree for dynamic lists; null for static lists.

member_count
integer | null

Stored member count for static lists; null for dynamic lists — use GET /v1/contact-lists/{listId}/member-count for a live count.

owner_campaign_id
string<uuid> | null

Set when the list is a blast's inline audience; null for user-created lists.