---
title: "Read your preparation test progress"
method: GET
path: "/v1/execute/{id}"
tags: ["Execution Preparations"]
---

# Read your preparation test progress

`GET /v1/execute/{id}`

## Request

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

Local-only authenticated status read. Missing and foreign jobs both return 404. Transaction bytes and wallet-provider references are never returned.

## Path parameters

- `id` string, uuid, required

## Response `200`

Preparation job and current public status

- union
  - ExecutionPreparation: Public preparation status only. Prepared means unsigned bytes were saved, not transaction safety approval or successful execution.
    - `job_id` string, uuid, required
    - `status` 'pending' | 'executing' | 'prepared' | 'failed' | 'needs_attention', required
    - `step` 'unprepared' | 'prepared', required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `error_code` string, nullable, required
    - `signing_attempted` false, required
    - `broadcast_attempted` false, required
  - ExecutionTradeJob: Local trade job. Confirmed chain success is succeeded; background finality may still hold funds.
    - `job_id` string, uuid, required
    - `status` 'pending' | 'executing' | 'confirming' | 'succeeded' | 'failed' | 'needs_attention', required
    - `step` 'unprepared' | 'prepared' | 'signing_requested' | 'signed' | 'submission_committed' | 'observing' | 'resolved', required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `error_code` string, nullable, required
    - `signing_attempted` boolean, required
    - `broadcast_attempted` boolean, required
    - `execution_mode` 'trade', required
    - `transaction_id` string, nullable, required

## Other responses

- `400`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `401`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `404`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `409`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `413`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `503`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.

---

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