# flow2act · Ausführung abrufen

Lies Status, Antragsdaten und Gate-Aufgaben.

Nur aktive angemeldete Mitglieder einer zugeordneten Freigabe- oder Kenntnisnahmegruppe mit offenem oder abgeschlossenem Schritt dürfen geschützte Inhalte lesen. Blockierte/abgebrochene Schritte, nicht zugeordnete Administratoren, Antragsteller und alle API-Keys gewähren keinen Inhaltszugriff. Aktuelle Rechte werden bei jedem Aufruf und jeder Wiederholung geprüft. Listen und Cursor beachten dieselbe Grenze. Neue Live-Vorgänge speichern Nachweise drei Kalendermonate im Free-Tarif oder zwölf in Bezahlmodellen nach Abschluss. Laufende Live-Vorgänge verfallen nicht altersbedingt. Bestehende längere Fristen bleiben erhalten. Sandbox bleibt bei 30 Tagen ab Erstellung.

## GET /v1/flow-runs/{runId}

Authentication: restricted integration key (scope: runs:read) or flow2act sign-in access token
Required tenant header: X-Organization-Id.
Required user permissions: Passende Freigabegruppe erforderlich. The API checks current membership, roles, key scopes and resource permissions on every request. Documentation visibility grants no access.

## Request example (replace example IDs)

```sh
curl "https://api.flow2act.com/v1/flow-runs/10000000-0000-4000-8000-000000000004" \
  -H "authorization: Bearer $FLOW2ACT_API_KEY" \
  -H "x-organization-id: 10000000-0000-4000-8000-000000000001"
```

## Response excerpt

```json
{
  "id": "10000000-0000-4000-8000-000000000004",
  "status": "waiting",
  "data": {
    "environment": "production"
  },
  "gates": [
    {
      "id": "10000000-0000-4000-8000-000000000005",
      "status": "pending"
    }
  ]
}
```

Source: /docs/get-run
Full schemas: /docs/openapi.json