Read Audience

gethttps://db.fullvision.io/v1/audiences/{id}

Returns one audience's definition, size, and status.

Use it when you want one audience in full — its rules, its size, and the snapshot the ad platforms are syncing from.

Fetch one audience by id, including the full AudienceCriteria tree and the latest snapshot summary.

Authorization

AuthorizationBearer <token>

API key as Bearer token

In: header

Path Parameters

id*string

Formatuuid

Responses

Compact row returned by list. Excludes criteria_json to keep payloads small.

id*string

Formatuuid

name*string

description?string|null

is_time_windowed*boolean

current_snapshot_id*|

ULID of the latest snapshot, or null if never refreshed.

previous_snapshot_id?|

ULID of the snapshot before the latest refresh, or null.

current_row_count*|

Range0 <= value

current_emailable_count?|

People in the current snapshot with a usable email.

Range0 <= value

refresh_interval_sec*integer

Range0 <= value

last_refreshed_at*|

Formatdate-time

last_refresh_error?string|null

archived_at?|

Formatdate-time

created_at*string

Formatdate-time

updated_at*string

Formatdate-time

workspace_id?string

Formatuuid

criteria_json*

Top-level audience criteria. The compiler walks root and emits one CH SELECT DISTINCT person_id query.

criteria_hash?string

Stable hash of criteria_json; changes iff the criteria change.

created_by_api_key_id?|

Formatuuid

get/v1/audiences/{id}

curl -X GET "https://db.fullvision.io/v1/audiences/497f6eca-6276-4993-bfeb-53cbbbba6f08"

Example Responses

{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "name": "string",  "description": "string",  "is_time_windowed": true,  "current_snapshot_id": "string",  "previous_snapshot_id": "string",  "current_row_count": 0,  "current_emailable_count": 0,  "refresh_interval_sec": 0,  "last_refreshed_at": "2019-08-24T14:15:22Z",  "last_refresh_error": "string",  "archived_at": "2019-08-24T14:15:22Z",  "created_at": "2019-08-24T14:15:22Z",  "updated_at": "2019-08-24T14:15:22Z",  "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9",  "criteria_json": {    "version": 1,    "root": {      "op": "and",      "children": [        null      ]    }  },  "criteria_hash": "string",  "created_by_api_key_id": "16a8c1ea-aaaf-49f0-9266-c657c48ceff3"}

application/json