Refiner

Get aggregated reporting and chart data. Requires project_uuid from get-projects. Filter by form UUIDs (surveys), segment UUIDs, tag UUIDs, question identifiers and date range. Filter by survey answers, contact traits and account traits with contact_data={"country": "France"}, account_data={"plan": "pro"} and/or response_data={"nps": 9, "question_2": "something"}. Keys are attribute slugs or UUIDs from get-traits (include=contact, include=account or include=form). Chart types: nps, csat, ratings, count, distribution. The date range defaults to the past 30 days and can extend back up to 12 months.

get-aggregated-response-data

List surveys in a project. Requires project_uuid from get-projects. Available lists: all, all_with_archived, archived, published, drafts.

get-forms-tool

List all projects (environments) the authenticated user can access. Call this first; use each project uuid as project_uuid in get-forms, get-segments, get-tags, get-responses, get-aggregated-response-data, and when using resources under refiner://project/{project_uuid}/....

get-projects

Get access to a list of survey responses. Requires project_uuid from get-projects. Filter by form UUIDs (surveys), segment UUIDs, tag UUIDs, and date range. Filter by survey answers, contact traits and account traits with contact_data={"country": "France"}, account_data={"plan": "pro"} and/or response_data={"nps": 9, "question_2": "something"}. Keys are attribute slugs or UUIDs from get-traits (include=contact, include=account or include=form). Returns up to 500 responses per page. Contact data is excluded from the payload for privacy reasons. The date range defaults to the past 30 days and can extend back up to 12 months.

get-responses-tool

List user segments in a project. Requires project_uuid from get-projects.

get-segments-tool

List response tags in a project. Requires project_uuid from get-projects.

get-tags-tool

List attributes (data fields) in a project. Requires project_uuid from get-projects. include options: all, form, contact, account. Use attribute slugs or UUIDs in response_data, contact_data or account_data filters (e.g. GetResponsesTool or GetAggregatedResponseDataTool)

get-traits-tool