---
title: "Poll an inbound run"
method: GET
path: "/api/v1/novasynth/inbound/runs/{runId}"
tags: ["NovaSynth"]
---

# Poll an inbound run

`GET /api/v1/novasynth/inbound/runs/{runId}`

## Request

- Base URL: `https://dev.noveum.ai`
- URL: `https://dev.noveum.ai/api/v1/novasynth/inbound/runs/{runId}`
- Auth: API key in cookie `apiKeyCookie` and HTTP bearer

Organization-scoped run status for the claim/poll loop. Unlike GET /novasynth/runs/:id this does not require a projectId, because a client that claimed a run only holds its id.

## Path parameters

- `runId` string, required

## Response `200`

Run status

- object
  - `success` boolean, required
  - `status` 'waiting' | 'arming' | 'ready' | 'in_progress' | 'completed' | 'failed' | 'expired' | 'cancelled', required
  - `runId` string
  - `phoneNumber` unknown
  - `dialWindowClosesAt` unknown
  - `profile` object
  - `personaName` string
  - `scenarioName` string
  - `retryAfterMs` number
  - `reason` string

## Other responses

- `201`: Created
- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `409`: Conflict
- `422`: Unprocessable entity
- `500`: Internal server error

---

[API](https://skmtc.dev/noveum/apis/noveum-api.md) · [All operations](https://skmtc.dev/noveum/apis/noveum-api/llms.txt) · [OpenAPI document](https://skmtc.dev/noveum/apis/noveum-api/revisions/1745e27f38d0?raw)