Page session nodes and scoped model-cost summaries without loading events

curl --request GET \
  --url https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/costs/sessions \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/costs/sessions"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/costs/sessions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/costs/sessions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/costs/sessions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/costs/sessions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "model_cost_snapshot_token": "example",
  "next_page_token": "example",
  "read_timestamp": "2026-02-18T09:30:00.000Z",
  "scope": "self",
  "session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
  "session_nodes": [
    {
      "model_costs": {
        "self": {
          "adjustment_count": "example",
          "attempt_count": "example",
          "charge_count": "example",
          "completeness": "complete",
          "model_cost_usd": "example",
          "scope": "self",
          "session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"
        },
        "session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
        "subtree": {
          "adjustment_count": "example",
          "attempt_count": "example",
          "charge_count": "example",
          "completeness": "complete",
          "model_cost_usd": "example",
          "scope": "self",
          "session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"
        },
        "tree": {
          "adjustment_count": "example",
          "attempt_count": "example",
          "charge_count": "example",
          "completeness": "complete",
          "model_cost_usd": "example",
          "scope": "self",
          "session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"
        }
      },
      "parent_session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
      "root_session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
      "session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
      "session_path": "example"
    }
  ]
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "forbidden",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "bad_gateway",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "gateway_timeout",
  "message": "<string>",
  "details": {}
}

GET

managed-agents

sessions

{session_id}

costs

sessions

Page session nodes and scoped model-cost summaries without loading events

curl --request GET \
  --url https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/costs/sessions \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/costs/sessions"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/costs/sessions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/costs/sessions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/costs/sessions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.recursion.labelbox.com/managed-agents/v1/sessions/{session_id}/costs/sessions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "model_cost_snapshot_token": "example",
  "next_page_token": "example",
  "read_timestamp": "2026-02-18T09:30:00.000Z",
  "scope": "self",
  "session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
  "session_nodes": [
    {
      "model_costs": {
        "self": {
          "adjustment_count": "example",
          "attempt_count": "example",
          "charge_count": "example",
          "completeness": "complete",
          "model_cost_usd": "example",
          "scope": "self",
          "session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"
        },
        "session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
        "subtree": {
          "adjustment_count": "example",
          "attempt_count": "example",
          "charge_count": "example",
          "completeness": "complete",
          "model_cost_usd": "example",
          "scope": "self",
          "session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"
        },
        "tree": {
          "adjustment_count": "example",
          "attempt_count": "example",
          "charge_count": "example",
          "completeness": "complete",
          "model_cost_usd": "example",
          "scope": "self",
          "session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d"
        }
      },
      "parent_session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
      "root_session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
      "session_id": "9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d",
      "session_path": "example"
    }
  ]
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "forbidden",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "bad_gateway",
  "message": "<string>",
  "details": {}
}

{
  "code": "analytics",
  "message": "<string>",
  "details": {}
}

{
  "code": "gateway_timeout",
  "message": "<string>",
  "details": {}
}

Authorizations

Authorization

string

header

required

A Recursion API key, created in the console under API keys.

Path Parameters

session_id

string<uuid>

required

Session id (UUID) the cost read is scoped to. Any id in the tree; scope decides how far the read reaches from it.

Query Parameters

scope

enum<string>

default:self

self selects only this session; subtree selects this session and descendants; tree selects the complete root tree.

Available options:

self,

subtree,

tree

limit

integer

default:50

Required range: 1 <= x <= 100

page_token

string

Signed, organization/session/scope/limit/snapshot-bound continuation token.

model_cost_snapshot_token

string

Signed token returned by a model-cost detail page. Pins this companion read to the exact same organization/session/scope snapshot.

Response

One page of the session hierarchy behind a model-cost read, paginated independently of the attempt detail so a wide tree cannot crowd out attempts.

model_cost_snapshot_token

string

required

Signed organization/session/scope-bound token that pins companion model-cost reads to this exact snapshot.

read_timestamp

string<date-time>

required

RFC 3339 timestamp of the database snapshot these rollups were read from.

scope

enum<string>

required

How far the hierarchy read reached from that session: this session alone (self), this session and its descendants (subtree), or every session under the same root (tree).

Available options:

self,

subtree,

tree

session_id

string

required

Session the read was scoped to (UUID).

session_nodes

object[] | null

required

Sessions in scope, ordered by session_path then session_id, up to the requested limit.

Show child attributes

next_page_token

string

Continuation for the next page, passed back as page_token. Absent on the last page, and bound to this organization, session, scope, limit, and snapshot.

API reference

Endpoints

Page session nodes and scoped model-cost summaries without loading events

Authorizations

Path Parameters

Query Parameters

Response