# Get Run Status

Retrieve the current status of a run by its ID.

## Overview
This endpoint allows you to quickly check the status of a run without retrieving all the detailed information.

## Path Parameters
- run_id: The unique identifier of the batch run (UUID format)

## Response
Returns the run ID and its current status.

## Examples

### Example Response
json
{
  "run_id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "completed"
}


### Possible Status Values
- queued: The run is queued
- completed: The run has completed successfully
- failed: The run has failed

## HTTP Status Codes

| Code | Meaning |
|------|---------|
| 200 OK | Run status retrieved successfully |
| 400 Bad Request | Invalid run ID format |
| 404 Not Found | Run not found |
| 500 Internal Server Error | Server error occurred while retrieving status |

Endpoint: GET /v1/agents/runs/{run_id}/status
Version: 1.4.1
Security: BearerAuth

## Path parameters:

  - `run_id` (string, required)

## Response 200 fields (application/json):

  - `run_id` (string, required)
    Unique identifier for the run
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `status` (string, required)
    Current status of the run
    Enum: "queued", "queued", "failed", "completed", "failed"

## Response 400 fields (application/json):

  - `success` (boolean)
    Always false for error responses

  - `error` (string, required)
    Error message

  - `details` (any)
    Additional error details

  - `request_id` (any)
    Request ID for tracking

## Response 401 fields (application/json):

  - `success` (boolean)
    Always false for error responses

  - `error` (string, required)
    Error message

  - `details` (any)
    Additional error details

  - `request_id` (any)
    Request ID for tracking

## Response 404 fields (application/json):

  - `success` (boolean)
    Always false for error responses

  - `error` (string, required)
    Error message

  - `details` (any)
    Additional error details

  - `request_id` (any)
    Request ID for tracking

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array, required)

  - `detail.msg` (string, required)

  - `detail.type` (string, required)

## Response 500 fields (application/json):

  - `success` (boolean)
    Always false for error responses

  - `error` (string, required)
    Error message

  - `details` (any)
    Additional error details

  - `request_id` (any)
    Request ID for tracking