To query the trace-level user_feedback annotations (e.g., those created by the thumbs-up button in the Session view), use the Phoenix client to retrieve trace annotations. The trace annotation for user feedback is stored with the name user_feedback and can be accessed via the API or SDK. You can use the TypeScript or Python SDK to fetch trace annotations, filtering by annotation name if needed. For example, in TypeScript, use `getTraceAnnotations` and specify `includeAnnotationNames: ["user_feedback"]` to retrieve only user feedback annotations for your traces. In Python, use the `get_trace_annotations` method or query the traces DataFrame and filter for the user_feedback annotation column.
For more details and code examples, see the documentation on <https://arize.com/docs/phoenix/sdk-api-reference/typescript/packages/phoenix-client/annotations|Annotations> and the <https://arize.com/docs/phoenix/release-notes/05-2026/05-15-2026-session-feedback-and-atif|release notes describing trace-level user_feedback>. Would you like a step-by-step code example for your preferred language?
Sources:
- <https://arize.com/docs/phoenix/sdk-api-reference/typescript/packages/phoenix-client/annotations|Annotations>
- <https://arize.com/docs/phoenix/release-notes/05-2026/05-15-2026-session-feedback-and-atif|05.15.2026: Session Trace Feedback and ATIF v1.7 Support>
