provider ingestion_warnings_v2 GET /api/projects/{project_id}/ingestion_warnings_v2/
@utdk/posthog /api/projects/{project_id}/ingestion_warnings_v2/
List ingestion warnings
Lists this project's ingestion warnings — events or person/group updates that were ingested with problems (oversized messages, rejected person merges, invalid data) — grouped by warning type. Each entry carries the warning's category and severity, the total count and a sparkline over the requested time range, and the most recent sample warnings with the affected event/person/group. Filter by category, type, severity or time range to drill into a specific problem.
category query
Only return warnings in this category (e.g. 'size', 'merge', 'event'). Warnings from producers that don't yet emit a category have category 'unknown'.
string
limit query
Maximum number of warning types to return (default 100).
integer
order_by query
Sort order for warning types: 'count' (most frequent first, the default) or 'last_seen' (most recent first). * `count` - count * `last_seen` - last_seen
enum: count, last_seen
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
q query
Only return warnings whose type or details contain this substring (case-sensitive). Useful for finding warnings about a specific distinct ID, event or property.
string
samples query
Maximum number of recent sample warnings to return per warning type (default 5).
integer
severity query
Only return warnings with this severity. Warnings from producers that don't yet emit a severity have severity 'warning'. * `info` - info * `warning` - warning * `error` - error
enum: info, warning, error
since query
Start of the time range, as an ISO 8601 datetime (e.g. '2026-07-01T00:00:00Z') or a relative duration (e.g. '-24h', '-7d'). Defaults to 24 hours ago. Warnings are retained for 90 days.
string
type query
Only return warnings of this type (e.g. 'message_size_too_large', 'cannot_merge_already_identified').
string
until query
End of the time range, as an ISO 8601 datetime or a relative duration (e.g. '-1h'). Defaults to now.
string

Try it

Authentication
Configure credentials for PostHog API
ingestionWarningsV2List
GET/api/projects/{project_id}/ingestion_warnings_v2/
Lists this project's ingestion warnings — events or person/group updates that were ingested with problems (oversized messages, rejected person merges, invalid data) — grouped by warning type. Each entry carries the warning's category and severity, the total count and a sparkline over the requested time range, and the most recent sample warnings with the affected event/person/group. Filter by category, type, severity or time range to drill into a specific problem.

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/.

Only return warnings in this category (e.g. 'size', 'merge', 'event'). Warnings from producers that don't yet emit a category have category 'unknown'.

Maximum number of warning types to return (default 100).

Sort order for warning types: 'count' (most frequent first, the default) or 'last_seen' (most recent first). * `count` - count * `last_seen` - last_seen

Only return warnings whose type or details contain this substring (case-sensitive). Useful for finding warnings about a specific distinct ID, event or property.

Maximum number of recent sample warnings to return per warning type (default 5).

Only return warnings with this severity. Warnings from producers that don't yet emit a severity have severity 'warning'. * `info` - info * `warning` - warning * `error` - error

Start of the time range, as an ISO 8601 datetime (e.g. '2026-07-01T00:00:00Z') or a relative duration (e.g. '-24h', '-7d'). Defaults to 24 hours ago. Warnings are retained for 90 days.

Only return warnings of this type (e.g. 'message_size_too_large', 'cannot_merge_already_identified').

End of the time range, as an ISO 8601 datetime or a relative duration (e.g. '-1h'). Defaults to now.

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.ingestionWarningsV2List()