---
title: "Get annotated queue interactions"
method: GET
path: "/api/v2/llm-obs/v1/annotation-queues/{queue_id}/annotated-interactions"
tags: ["LLM Observability"]
---

# Get annotated queue interactions

`GET /api/v2/llm-obs/v1/annotation-queues/{queue_id}/annotated-interactions`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/llm-obs/v1/annotation-queues/{queue_id}/annotated-interactions`
- Auth: API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`

Retrieve all interactions (traces and sessions) and their annotations for a given annotation queue.

## Path parameters

- `queue_id` string, required

## Response `200`

OK

- LLMObsAnnotatedInteractionsResponse: Response containing the annotated interactions for an annotation queue.
  - `data` LLMObsAnnotatedInteractionsDataResponse, required: Data object for annotated interactions.
    - `attributes` LLMObsAnnotatedInteractionsDataAttributesResponse, required: Attributes containing the list of annotated interactions.
      - `annotated_interactions` LLMObsAnnotatedInteractionItem[], required: List of interactions with their annotations.
        - union: An interaction with its associated annotations.
          - LLMObsTraceAnnotatedInteractionItem: A trace, experiment trace, or session interaction with its associated annotations.
            - `annotations` LLMObsAnnotationItem[], required: List of annotations for this interaction.
              - …
            - `content_id` string, required: Upstream entity identifier supplied by the caller.
            - `created_at` string, date-time, required: Timestamp when the interaction was added to the queue.
            - `id` string, required: Unique identifier of the interaction.
            - `modified_at` string, date-time, required: Timestamp when the interaction was last updated.
            - `type` 'trace' | 'experiment_trace' | 'session', required: Type of an upstream-entity interaction.
          - LLMObsDisplayBlockAnnotatedInteractionItem: A display_block interaction with its associated annotations.
            - `annotations` LLMObsAnnotationItem[], required: List of annotations for this interaction.
              - …
            - `content_id` string, required: Server-generated deterministic identifier derived from the block list.
            - `display_block` LLMObsContentBlock[], required: List of content blocks that make up a `display_block` interaction. Must contain at least one block.
              - …
            - `id` string, required: Unique identifier of the interaction.
            - `type` 'display_block', required: Type discriminator for a `display_block` interaction.
    - `id` string, required: The annotation queue ID.
    - `type` 'annotated_interactions', required: Resource type for annotated interactions.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)