Overview

The Phoenix REST API allows you to access and interact with observability data programmatically. You can use it to retrieve project information, query traces and spans, access prompts, and automate analysis workflows directly from your environment.

Example Request

Get dataset by ID

cURL

curl -L \
  --url '/v1/datasets'

JavaScript

// Get dataset by ID
const response = await fetch('/v1/datasets/{id}', {
    method: 'GET',
});

const data = await response.json();

Python

# Get dataset by ID
import requests

response = requests.get(
    "/v1/datasets/{id}",
)

data = response.json()

HTTP

GET /v1/datasets/{id} HTTP/1.1
Host: 
Accept: */*

Example Response

{
  "data": [
    {
      "id": "version_123",
      "dataset_id": "your_dataset_id",
      "created_at": "2025-04-18T21:23:18.216Z",
      "metadata": {
        "source": "inference-logs"
      }
    }
  ],
  "next_cursor": null
}