# Retrieve a Workflow Run

Retrieves the details of a Workflow Run by ID.

## Request

```curl
curl https://api.stripe.com/v2/extend/workflow_runs/wfrun_test_61UTL7vuMHzp5fHTd16TT0rUFzSQLefl99yAJBArITFo \
  -H "Authorization: Bearer <<YOUR_SECRET_KEY>>" \
  -H "Stripe-Version: 2026-04-22.preview"
```

### Response

```json
{
  "id": "wfrun_test_61UTL7vuMHzp5fHTd16TT0rUFzSQLefl99yAJBArITFo",
  "object": "v2.extend.workflow_run",
  "created": "2026-04-08T14:33:27.076Z",
  "status": "succeeded",
  "status_details": {
    "failed": null,
    "started": {},
    "succeeded": {}
  },
  "status_transitions": {
    "failed_at": null,
    "started_at": "2026-04-08T14:33:27.335Z",
    "succeeded_at": "2026-04-08T14:33:29.177Z"
  },
  "trigger": {
    "event_trigger": {
      "id": "evt_1TJxAYHa3TtWqyXkmZHWuTlk",
      "context": "acct_1Nv0FGQ9RKHgCVdK",
      "type": "customer.created"
    },
    "type": "event_trigger"
  },
  "workflow": "wf_test_61UNwDso5RkJhsXt116TT0rUFzSQLefl99yAJBArIFXc",
  "livemode": false
}
```

## Returns

## Response attributes

- `id` (string)
  The unique ID of the Workflow Run.

- `object` (string, value is "v2.extend.workflow_run")
  String representing the object’s type. Objects of the same type share the same value of the object field.

- `created` (timestamp)
  When the Workflow Run was created.

- `livemode` (boolean)
  Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.

- `status` (enum)
  The current Workflow Run execution status.
Possible enum values:
  - `failed`
    This Workflow Run has terminated because of a failure.

  - `started`
    This Workflow Run is actively executing.

  - `succeeded`
    This Workflow Run has progressed to a successful completion.

- [`status_details`](https://docs.stripe.com/api/v2/extend/workflow-runs/retrieve.md?query=status_details&api-version=2026-04-22.preview) (object, nullable)
  Details about the Workflow Run’s status transitions.

- [`status_transitions`](https://docs.stripe.com/api/v2/extend/workflow-runs/retrieve.md?query=status_transitions&api-version=2026-04-22.preview) (object)
  Summary information about the Workflow Run’s status transitions.

- [`trigger`](https://docs.stripe.com/api/v2/extend/workflow-runs/retrieve.md?query=trigger&api-version=2026-04-22.preview) (object)
  A record of the trigger that launched this Workflow Run.

- `workflow` (string)
  The Workflow this Run belongs to.

## Error Codes

| HTTP status code | Code | Description |
| --- | --- | --- |
| 404 | not_found | The resource wasn’t found. |