> For the complete documentation index, see [llms.txt](/llms.txt).
> A full single-fetch corpus is available at [llms-full.txt](/llms-full.txt).
---
title: "Journal links"
description: "Fetch links back to the durable execution journal entries behind a run's items, for step-by-step debugging."
method: "GET"
endpoint: "/api/v1/projects/:projectId/eval/journal-links"
order: 17
group: "Analyze a run"
last_verified: 2026-07-27
---

<ApiEndpoint method="GET" endpoint="/api/v1/projects/:projectId/eval/journal-links" description="Fetch links back to the durable execution journal entries behind a run's items, for step-by-step debugging.">
  <section>
    #### Query parameters
    <ApiAttribute name="journal_id" type="string" description="Filter to a single journal entry. Alias: trace_id." required={false} />
    <ApiAttribute name="target_run_id" type="string" description="Filter to a single run." required={false} />
    <ApiAttribute name="span_id" type="string" description="Filter to a single span." required={false} />
    <ApiAttribute name="root_span_id" type="string" description="Filter to a single root span." required={false} />
    <ApiAttribute name="session_id" type="string" description="Filter to a single session." required={false} />
    <ApiAttribute name="root_run_id" type="string" description="Filter to a single root run." required={false} />
    <ApiAttribute name="page" type="integer" description="Page number. Defaults to 1." required={false} />
    <ApiAttribute name="page_size" type="integer" description="Results per page. Defaults to 50." required={false} />
  </section>

  <Callout type="info">
At least one of `journal_id`/`trace_id`, `target_run_id`, `span_id`, `root_span_id`, `session_id`, or `root_run_id` is required. Omitting all of them returns a `400` with the message "At least one journal link filter is required".
  </Callout>
</ApiEndpoint>