---
title: "Get Agent Execution"
method: GET
path: "/v1/agent/executions/{id}"
tags: ["agent"]
---

# Get Agent Execution

`GET /v1/agent/executions/{id}`

## Request

- Base URL: `https://api.vlm.run` (the document declares no server; this is the origin it was published from)
- URL: `https://api.vlm.run/v1/agent/executions/{id}`
- Auth: HTTP bearer

Get agent execution by ID.

## Path parameters

- `id` string, required

## Response `200`

Successful Response

- AgentExecutionResponse: Response to the agent execution request.
  - `usage` CreditUsageResponse: Response model for credit usage metrics.
    - `elements_processed` integer, nullable: Number of elements processed.
    - `element_type` 'image' | 'page' | 'video' | 'audio', nullable: The type of element processed (e.g. image, page, video, audio).
    - `credits_used` integer, nullable: Amount of total credits used.
    - `steps` integer, nullable: Number of steps processed, in case of agentic execution.
    - `message` string, nullable: The message from the credit usage job.
    - `duration_seconds` integer: Duration of the request in seconds.
    - `service_tier` string, nullable: Delivery tier (standard, priority, flex).
    - `mode_multiplier` number, nullable: Pricing multiplier applied to standard cost.
    - `standard_cost_dollars` number, nullable: Pre-multiplier customer cost in USD, derived from tokens and unit rates.
    - `cost_dollars` number, nullable: Effective customer cost in USD after the service-tier multiplier.
    - `savings_dollars` number, nullable: Discount in USD when using flex (standard_cost_dollars - cost_dollars).
  - `id` string: Unique identifier of the agent execution response.
  - `name` string, required: Name of the agent
  - `response` unknown
  - `execution_mode` 'agent' | 'program': How the execution ran: `program` when a cached skill pipeline.py ran as fixed code (no LLM agent loop), else `agent`. Always `agent` for non-Orion-2 models.
  - `status` 'pending' | 'enqueued' | 'running' | 'completed' | 'failed' | 'paused': The status of the job.
  - `fallback` boolean: True when the JSON was produced by a fallback model. False when the primary model succeeded.
  - `created_at` string, date-time: Date and time when the execution was created (in UTC timezone)
  - `completed_at` string, date-time, nullable: Date and time when the execution was completed (in UTC timezone)

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-19** `4a68ab36546b`: 1 info
  - added the optional property `fallback` to the response with the `200` status

[Operation history](https://skmtc.dev/vlm/apis/vlm-run-unified-server/changes/v1/agent/executions/:id/get.md)

---

[API](https://skmtc.dev/vlm/apis/vlm-run-unified-server.md) · [All operations](https://skmtc.dev/vlm/apis/vlm-run-unified-server/llms.txt) · [OpenAPI document](https://skmtc.dev/vlm/apis/vlm-run-unified-server/revisions/4a68ab36546b?raw)