Skip to main content
GET
Get Ask AI Logs
Data is sourced from BigQuery — expect a 5–15 minute lag for the most recent events. All dates and timestamps are UTC. Responses are tenant-scoped to the API key and are rate limited (default 60 requests/minute per key; X-RateLimit-* headers are returned, 429 with Retry-After when exceeded) and cached server-side for up to 30 minutes (send Cache-Control: no-cache to skip the cache read; the X-Cache response header reports HIT, MISS, BYPASS, or DISABLED).
This is a record-level endpoint for inspecting individual conversations. For aggregate KPIs and time-series use Ask AI Analytics instead.
If either start_date or end_date is omitted, both default to the trailing 7-day window ending today UTC. page must be ≥ 1; limit defaults to 50 and is clamped to a hard max of 500 (larger values are silently reduced). When interaction_type is omitted the service defaults to free_form, automated_followup, and search.

Authorizations

Authorization
string
header
required

Bearer token authentication using your Dappier API key. Get your API key at https://platform.dappier.com/profile/api-keys.

Query Parameters

start_date
string<date>

Inclusive start of the analytics window, formatted YYYY-MM-DD (UTC). Optional — if either start_date or end_date is omitted, both default to the trailing 7-day window ending today_UTC (i.e., start_date = today_UTC - 6).

Example:

"2026-05-01"

end_date
string<date>

Inclusive end of the analytics window, formatted YYYY-MM-DD (UTC). Optional — if either start_date or end_date is omitted, both default to the trailing 7-day window ending today_UTC. Must be on or after start_date; the total range must be ≤ 365 days.

Example:

"2026-05-18"

widget_id
string

Filter to one widget. Omit for all widgets the account owns.

Example:

"wd_92831"

placement_id
string

Filter to one placement.

deployment_type
string

Filter by deployment type (exact match).

Example:

"brand_agent"

interaction_type
string

Single value. When omitted, the service defaults to free_form, automated_followup, and search.

Example:

"free_form"

page
integer
default:1

1-based page number. Must be ≥ 1.

Required range: x >= 1
Example:

1

limit
integer
default:50

Page size. Hard max 500 — larger values are clamped down.

Required range: x <= 500
Example:

100

Response

A page of conversation log rows, newest-first.

data
object[]

Conversation log rows, newest-first by timestamp.

total_pages
integer

Total pages for the current limit.

Example:

12

count
integer

Total matching rows across all pages.

Example:

573

meta
object