---
title: "Get Template Run"
method: GET
path: "/v1/flows/templates/{template_id}/runs/{run_id}"
tags: ["Flows", "Templates"]
---

# Get Template Run

`GET /v1/flows/templates/{template_id}/runs/{run_id}`

Retrieve a template run: its `status`, rolled up from its outputs, and each output's own status and download URL once completed.

## Path parameters

- `template_id` string, required — The ID of the template, as shown in the ElevenLabs app or by `GET /v1/flows/templates`.
- `run_id` string, required

## Headers

- `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Response `200`

Successful Response

- TemplateRunResponse — A template run and its outputs. Every output exists from the moment the run is created and reports its own `status`; the run's `status` rolls them up, and the run is finished once it is `completed` or `failed`.
  - `id` string, required — The unique identifier of the run.
  - `template_id` string, required — The template this run executed, so a webhook consumer running several templates can tell their runs apart without keeping a run-to-template map.
  - `version_id` string, required — The template version this run executed. Resolved when the run is created, so a run started with `latest` records the concrete version it ran.
  - `status` 'pending' | 'generating' | 'completed' | 'failed', required — Where a run, or one of its outputs, is in its lifecycle. The run's is rolled up from its outputs' (``aggregate_output_statuses``). A class rather than a ``Literal`` so it publishes as one named enum instead of being inlined into every kind.
  - `outputs` object, required — The run's outputs, keyed by output port id. Each is a `TemplateOutput` discriminated on `type`, the `type` of its port's `content_schema`.

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-22** `6fb9be1a19f5` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/flows/templates/:template_id/runs/:run_id/get.md)

---

[API](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation.md) · [All operations](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/revisions/48a38e3b0dbd?raw)