Sign in

v31

latestOpenAPI 3.1.0Apache-2.0raw.githubusercontent.com2026-08-053042165.2 KB
Feedback Records

List feedback records with filters

Lists feedback records for a required tenant_id with optional additional filters and pagination

get/v1/feedback-records

Query parameters

tenant_idstring required

Tenant ID (required for isolation). NULL bytes not allowed.

Example:org-123

Tenant ID (required for isolation). NULL bytes not allowed.

submission_idstring

Filter by submission ID (e.g. UUID from webhook idempotency). NULL bytes not allowed.

Example:550e8400-e29b-41d4-a716-446655440000

Filter by submission ID to group records belonging to one logical submission. NULL bytes not allowed.

source_typestring

Filter by source type. NULL bytes not allowed.

Example:survey

Filter by source type. NULL bytes not allowed.

source_idstring

Filter by source ID (NULL bytes not allowed)

Example:survey-123

Filter by source ID (NULL bytes not allowed)

field_idstring
Example:q1

Filter by field ID. NULL bytes not allowed.

field_group_idstring

Filter by field group ID (for ranking/matrix questions). NULL bytes not allowed.

Example:feature_priority

Filter by field group ID (for ranking/matrix questions). NULL bytes not allowed.

field_type'text' | 'categorical' | 'nps' | 'csat' | 'ces' | 'rating' | 'number' | 'boolean' | 'date'

Filter by field type. NULL bytes not allowed.

Filter by field type. NULL bytes not allowed.

value_idstring

Filter by the source system's stable option id. NULL bytes not allowed.

Example:opt_very_satisfied

Filter by the source system's stable option id (e.g. all records for one survey choice). NULL bytes not allowed.

user_idstring

Filter by user ID. NULL bytes not allowed.

Example:user-abc-123

Filter by user ID. NULL bytes not allowed.

sincestring date-time

Filter by collected_at >= since (ISO 8601 format). Must be between 1970-01-01 and 2080-12-31.

Example:2024-01-01T00:00:00Z

Filter by collected_at >= since (ISO 8601 format). Must be between 1970-01-01 and 2080-12-31.

untilstring date-time

Filter by collected_at <= until (ISO 8601 format). Must be between 1970-01-01 and 2080-12-31.

Example:2024-12-31T23:59:59Z

Filter by collected_at <= until (ISO 8601 format). Must be between 1970-01-01 and 2080-12-31.

limitinteger

Number of results to return (max 1000)

Number of results to return (max 1000)

cursorstring
Example:eyJ0IjoiMjAyNC0wMS0xNVQxMDozMDowMFoiLCJpIjoiMDE4ZTEyMzQtNTY3OC05YWJjLWRlZjAtMTIzNDU2Nzg5YWJjIn0=

Omit for the first page. For the next page, use the exact value from the previous response's next_cursor. Opaque (base64-encoded); keyset pagination.

Response

OK

limitinteger required

Limit used in query

next_cursorstring

Opaque cursor for the next page (keyset paging). Present only when there may be more results. Use as the cursor query param for the next page.