To fetch spans and their annotations in Phoenix, you must first retrieve the spans (e.g., using `get_spans_dataframe`), then separately fetch annotations using `get_span_annotations_dataframe` by passing either the spans dataframe or a list of span IDs. There is no single API call that returns both spans and their annotations together; you must join the two dataframes yourself. See the example below:
```
from phoenix.client import Client
client = Client()
spans = client.spans.get_spans_dataframe(project_identifier="default")
annotations = client.spans.get_span_annotations_dataframe(spans_dataframe=spans, project_identifier="default")
result = annotations.join(spans, how="left")
```
If you are not seeing annotations, ensure you are using the correct project identifier and that your spans actually have annotations. Also, check that you are not filtering out annotation names unintentionally. For more, see the official <https://arize.com/docs/phoenix/tracing/how-to-tracing/importing-and-exporting-traces/exporting-annotated-spans|Exporting Annotated Spans guide>.
Would you like a step-by-step troubleshooting guide?
Sources:
- <https://arize.com/docs/phoenix/tracing/how-to-tracing/importing-and-exporting-traces/exporting-annotated-spans|Exporting Annotated Spans guide>
- <https://arize.com/docs/phoenix/sdk-api-reference/rest-api/annotations|Phoenix Annotations API Reference>
