---
title: "Read one execution at the executor host"
method: GET
path: "/v1/connections/{connectionId}/executions/{executionId}"
---

# Read one execution at the executor host

`GET /v1/connections/{connectionId}/executions/{executionId}`

## Request

- Base URL: `https://api.decionis.com`
- URL: `https://api.decionis.com/v1/connections/{connectionId}/executions/{executionId}`
- Auth: API key in header `X-Decionis-API-Key`

Where one execution is: HELD, CLAIMED, SETTLED or BLOCKED, its outcome, decision, permit and the finalization the authority recorded. Only the connection that created it can read it, at its current revision.

## Path parameters

- `connectionId` string, uuid, required
- `executionId` string, uuid, required

## Headers

- `X-ERP-Region` string, required

## Response `200`

The execution

- ExecutionView
  - `execution_id` string, required
  - `state` 'BLOCKED' | 'HELD' | 'CLAIMING' | 'CLAIMED' | 'SETTLING' | 'SETTLED', required
  - `outcome` string, required
  - `executor` object, required
    - `platform` string, required
    - `style` 'permit', required
    - `version` string, required
  - `action_type` string, required
  - `decision` string, required
  - `reason_codes` string[], required
  - `dossier_id` string, nullable, required
  - `permit_id` string, nullable, required
  - `intent_sha256` string, nullable, required
  - `expires_at` string, date-time, nullable, required
  - `finalization` 'RECORDED' | 'PENDING' | 'UNSUPPORTED' | 'null', nullable, required
  - `created_at` string, date-time, required
  - `claimed_at` string, date-time, nullable, required
  - `settled_at` string, date-time, nullable, required

## Other responses

- `400`: Bounded error response
- `401`: Bounded error response
- `404`: Bounded error response
- `409`: Bounded error response

---

[API](https://skmtc.dev/decionis/apis/decionis-commerce-gate-api.md) · [All operations](https://skmtc.dev/decionis/apis/decionis-commerce-gate-api/llms.txt) · [OpenAPI document](https://skmtc.dev/decionis/apis/decionis-commerce-gate-api/revisions/9fecb7109bf8?raw)