---
title: "Check the current status of a project run"
method: GET
path: "/riveter/v1/run_status"
tags: ["Riveter"]
---

# Check the current status of a project run

`GET /riveter/v1/run_status`

## Request

- Base URL: `https://api.orthogonal.com/mpp`
- URL: `https://api.orthogonal.com/mpp/riveter/v1/run_status`
- Auth: none declared
- TypeScript: <https://skmtc.dev/orthogonal/apis/orthogonal-api-marketplace/docs/riveter/v1/run_status/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `run_key` string, required

## Response `200`

Successful response

## Changes

- **2026-11-08** `857e915717f4`: 1 breaking
  - added the new required `query` request parameter `run_key`
- **2026-08-25** `806e279c8d50`: 2 info
  - api tag `Riveter` added
  - api tag `Riveter API` removed

[Operation history](https://skmtc.dev/orthogonal/apis/orthogonal-api-marketplace/changes/riveter/v1/run_status/get.md)

---

[API](https://skmtc.dev/orthogonal/apis/orthogonal-api-marketplace.md) - [All operations](https://skmtc.dev/orthogonal/apis/orthogonal-api-marketplace/llms.txt) - [OpenAPI document](https://skmtc.dev/orthogonal/apis/orthogonal-api-marketplace/revisions/fc2e1d26c8eb?raw)