Skip to main content
GET
/
migrations
/
{migration_id}
/
runs
/
{run_id}
Poll a run
curl --request GET \
  --url https://app.vern.so/api/v1/migrations/{migration_id}/runs/{run_id} \
  --header 'x-api-key: <api-key>'
{
  "run_id": "d4c3b2a1-...",
  "status": "running",
  "created_at": "2026-06-19T15:32:11.000Z",
  "message": "Cleaning your data"
}

Authorizations

​
x-api-key
string
header
required

Your Vern API key. Create one at Settings → API keys.

Path Parameters

​
migration_id
string<uuid>
required

The migration ID returned by Create a migration.

​
run_id
string<uuid>
required

The run ID returned by Start a run.

Response

The run's current state.

A run's polled state. Fields beyond run_id/status/created_at depend on status.

​
run_id
string<uuid>
​
status
enum<string>
Available options:
queued,
running,
blocked,
awaiting_approval,
completed,
failed,
canceled
​
created_at
string<date-time>
​
message
string | null

Present while queued/running.

​
questions
object[]

Present when blocked.

​
report
object
​
error
string

Present when failed.