List responses
List individual participant responses. Paginated. Optional filters narrow the result to one respondent or one exact submission: user_id (globally-unique, canonical), platform_id + provider (the respondent's platform account, which must be paired because platform_id is only unique within its namespace), and session_number. Combine a respondent filter with session_number — e.g. ?user_id=44821&session_number=1 — to fetch the single submission behind a response.submitted webhook.
Anonymous projects: if the project's privacy_mode is anonymous, user_id, platform_id and session_number are returned as null and all three are rejected as filters with a 400 — otherwise the redaction would be cosmetic, since a caller who filters by respondent and reads back a non-empty page has learned who answered. Fetch a single anonymous submission by its id via GET .../responses/{responseId} instead.
Request
- Base URL: https://api.subo.ai
- URL: https://api.subo.ai/v1/communities/{communityId}/projects/{projectId}/responses
- Auth: API key in header X-API-Key
Path parameters
Community ID (Discord guild snowflake, serialized as string)
Project ID
Query parameters
Filter to one respondent by globally-unique Subo user id. The unambiguous exact-fetch key. Rejected with a 400 on anonymous projects.
Filter by the respondent's platform account id (e.g. Discord snowflake). Must be paired with provider; returns 400 otherwise. Rejected with a 400 on anonymous projects.
Account namespace for platform_id.
Filter to a single completion index. Combine with a respondent filter for exactly one submission. Rejected with a 400 on anonymous projects.
Response
Paginated list of responses
Changes
No recorded changes to this operation across all 1 revision of this API.