provider conversations GET /api/projects/{project_id}/conversations/tickets/
@utdk/posthog /api/projects/{project_id}/conversations/tickets/
conversations_tickets_list
List tickets with person data attached.
assignee query
Filter by assignee. Use `unassigned` for tickets with no assignee, `user:<user_id>` for a specific user, or `role:<role_uuid>` for a role.
string
channel_detail query
Filter by the channel sub-type (e.g. `widget_embedded`, `slack_bot_mention`).
enum: github_issue, slack_bot_mention, slack_channel_message, slack_emoji_reaction…
channel_source query
Filter by the channel the ticket originated from.
enum: email, github, slack, teams…
date_from query
Only include tickets updated on or after this date. Accepts absolute dates (`2026-01-01`) or relative ones (`-7d`, `-1mStart`). Pass `all` to disable the filter.
string
date_to query
Only include tickets updated on or before this date. Same format as `date_from`.
string
distinct_ids query
Comma-separated list of person `distinct_id`s to filter by (max 100).
string
limit query
Number of results to return per page.
integer
offset query
The initial index from which to return the results.
integer
order_by query
Sort order. Prefix with `-` for descending. Defaults to `-updated_at`.
enum: -created_at, -sla_due_at, -ticket_number, -updated_at…
priority query
Filter by priority. Accepts a single value or a comma-separated list (e.g. `medium,high`). Valid values: `low`, `medium`, `high`.
string
project_id path required
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
string
search query
Free-text search. A numeric value matches a ticket number exactly; otherwise matches against the customer's name or email (case-insensitive, partial match).
string
sla query
Filter by SLA state. `breached` = past `sla_due_at`, `at-risk` = due within the next hour, `on-track` = more than an hour remaining.
enum: at-risk, breached, on-track
status query
Filter by status. Accepts a single value or a comma-separated list (e.g. `new,open,pending`). Valid values: `new`, `open`, `pending`, `on_hold`, `resolved`.
string
tags query
JSON-encoded array of tag names; returns tickets with ANY of them (OR), e.g. `["billing","urgent"]`.
string
tags_all query
JSON-encoded array of tag names; returns tickets that have ALL of them (AND), e.g. `["billing","urgent"]`.
string
tags_exclude query
JSON-encoded array of tag names; returns tickets that have NONE of them (NOT), e.g. `["escalated"]`.
string

Try it

Authentication
Configure credentials for PostHog API
conversationsTicketsList
GET/api/projects/{project_id}/conversations/tickets/
List tickets with person data attached.

Parameters

required

Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.

Filter by assignee. Use `unassigned` for tickets with no assignee, `user:<user_id>` for a specific user, or `role:<role_uuid>` for a role.

Filter by the channel sub-type (e.g. `widget_embedded`, `slack_bot_mention`).

Filter by the channel the ticket originated from.

Only include tickets updated on or after this date. Accepts absolute dates (`2026-01-01`) or relative ones (`-7d`, `-1mStart`). Pass `all` to disable the filter.

Only include tickets updated on or before this date. Same format as `date_from`.

Comma-separated list of person `distinct_id`s to filter by (max 100).

Number of results to return per page.

The initial index from which to return the results.

Sort order. Prefix with `-` for descending. Defaults to `-updated_at`.

Filter by priority. Accepts a single value or a comma-separated list (e.g. `medium,high`). Valid values: `low`, `medium`, `high`.

Free-text search. A numeric value matches a ticket number exactly; otherwise matches against the customer's name or email (case-insensitive, partial match).

Filter by SLA state. `breached` = past `sla_due_at`, `at-risk` = due within the next hour, `on-track` = more than an hour remaining.

Filter by status. Accepts a single value or a comma-separated list (e.g. `new,open,pending`). Valid values: `new`, `open`, `pending`, `on_hold`, `resolved`.

JSON-encoded array of tag names; returns tickets with ANY of them (OR), e.g. `["billing","urgent"]`.

JSON-encoded array of tag names; returns tickets that have ALL of them (AND), e.g. `["billing","urgent"]`.

JSON-encoded array of tag names; returns tickets that have NONE of them (NOT), e.g. `["escalated"]`.

Configure credentials above to enable sending.

Code snippet
Updates live as you fill in the form above.

TypeScript

import posthog from '@utdk/posthog';

await posthog.conversationsTicketsList()