from retab import Retab

client = Retab()

steps = client.workflows.steps.list("run_abc123xyz")

for step in steps.data:
    print(step.block_id, step.lifecycle.status, step.artifact)

import { Retab } from "@retab/node";

const client = new Retab({ apiKey: process.env.RETAB_API_KEY });

const steps = await client.workflows.steps.list({ runId: "run_abc123xyz" });

for (const step of steps.data) {
  console.log(step.blockId, step.lifecycle.status, step.artifact);
}

package main

import (
	"context"
	"fmt"
	"log"

	retab "github.com/retab-dev/retab/clients/go"
)

func ptr[T any](v T) *T { return &v }

func main() {
	ctx := context.Background()

	client, err := retab.NewClient("")
	if err != nil {
		log.Fatal(err)
	}

	steps, err := client.Workflows.Steps.List(ctx, &retab.WorkflowStepsListParams{
		RunID: ptr("run_abc123xyz"),
	})
	if err != nil {
		log.Fatal(err)
	}

	for _, step := range steps.Data {
		fmt.Println(step.BlockID, step.Lifecycle.Status())
	}
}

require 'retab'

client = Retab::Client.new(api_key: ENV['RETAB_API_KEY'])

steps = client.workflows.steps.list(run_id: 'run_abc123xyz')

steps.data.each do |step|
  puts "#{step.block_id} #{step.lifecycle.status} #{step.artifact}"
end

use retab::resources::workflow_steps::ListParams;
use retab::Retab;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Retab::new(std::env::var("RETAB_API_KEY")?);

    let steps = client
        .workflows().steps()
        .list(ListParams {
            run_id: Some("run_abc123xyz".into()),
            ..Default::default()
        })
        .await?;

    for step in &steps.data {
        println!("{} {:?} {:?}", step.block_id, step.lifecycle, step.artifact);
    }
    Ok(())
}

<?php
require 'vendor/autoload.php';

use Retab\Client;

$client = new Client(apiKey: getenv('RETAB_API_KEY'));

$result = $client->workflows()->steps()->list();
print_r($result);

using Retab;
using RetabClient = Retab.Retab;

var apiKey = Environment.GetEnvironmentVariable("RETAB_API_KEY")!;
var client = new RetabClient(apiKey);

var result = await client.Workflows.Steps.ListAsync(new WorkflowStepsListOptions());
Console.WriteLine(result);

import com.retab.RetabClient;

public final class Example {
  public static void main(String[] args) throws Exception {
    RetabClient client = new RetabClient(System.getenv("RETAB_API_KEY"));

    var result = client.workflows().steps().list("run_abc123", null, "block_abc123", "step_abc123", null, null, null, null, 10L);
    System.out.println(result);
  }
}

curl -X 'GET' \
  'https://api.retab.com/v1/workflows/steps?run_id=run_abc123xyz' \
  -H 'Authorization: Bearer <your-api-key>'

{
  "data": [
    {
      "run_id": "run_abc123xyz",
      "block_id": "extract-block-1",
      "step_id": "extract-block-1",
      "block_type": "extract",
      "block_label": "Extract Invoice",
      "lifecycle": { "status": "completed" },
      "artifact": { "operation": "extraction", "id": "ext_abc123" },
      "started_at": "2026-03-12T09:00:00Z",
      "completed_at": "2026-03-12T09:00:03Z",
      "handle_outputs": {
        "output-json-0": {
          "type": "json",
          "data": {
            "invoice_number": "INV-2024-001",
            "total_amount": 1234.56
          }
        }
      },
      "handle_inputs": {
        "input-file-0": {
          "type": "file",
          "document": {
            "id": "file_123",
            "filename": "invoice.pdf",
            "mime_type": "application/pdf"
          }
        }
      },
      "created_at": "2026-03-12T09:00:00Z"
    },
    {
      "run_id": "run_abc123xyz",
      "block_id": "split-block-1",
      "step_id": "split-block-1",
      "block_type": "split",
      "block_label": "Split Documents",
      "lifecycle": { "status": "completed" },
      "artifact": { "operation": "split", "id": "spl_def456" },
      "started_at": "2026-03-12T09:00:03Z",
      "completed_at": "2026-03-12T09:00:04Z",
      "handle_outputs": {
        "output-file-invoice": {
          "type": "file",
          "document": {
            "id": "file_456",
            "filename": "invoice_page_1.pdf",
            "mime_type": "application/pdf"
          }
        }
      },
      "handle_inputs": {
        "input-file-0": {
          "type": "file",
          "document": {
            "id": "file_123",
            "filename": "invoice.pdf",
            "mime_type": "application/pdf"
          }
        }
      },
      "created_at": "2026-03-12T09:00:03Z"
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

{
  "detail": "Workflow run not found"
}