from retab import Retab

client = Retab()

step = client.workflows.steps.get("step_extract_1")

print(step.lifecycle.status)
print(step.handle_outputs)

if step.handle_outputs:
    payload = step.handle_outputs["output-json-0"]
    print(payload.type)
    print(payload.data)

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

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

const step = await client.workflows.steps.get("step_extract_1");

console.log(`Step status: ${step.lifecycle.status}`);
const payload = step.handleOutputs["output-json-0"];
if (payload?.type === "json") {
  console.log(payload.data);
}

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)
	}

	step, err := client.Workflows.Steps.Get(ctx, "step_extract_1", nil)
	if err != nil {
		log.Fatal(err)
	}

	fmt.Printf("Step status: %v\n", step.Lifecycle.Status())
	if payload, ok := step.HandleOutputs["output-json-0"]; ok {
		fmt.Println(payload.Type)
		fmt.Println(payload.Data)
	}
}

require 'retab'

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

step = client.workflows.steps.get(step_id: 'step_extract_1')

puts step.lifecycle.status
puts step.handle_outputs

if step.handle_outputs
  payload = step.handle_outputs['output-json-0']
  puts payload.type
  puts payload.data
end

use retab::resources::workflow_steps::GetParams;
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 step = client
        .workflows().steps()
        .get("step_extract_1", GetParams::default())
        .await?;

    println!("{:?}", step.lifecycle);
    if let Some(outputs) = &step.handle_outputs {
        if let Some(payload) = outputs.get("output-json-0") {
            println!("{:?}", payload);
        }
    }
    Ok(())
}

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

use Retab\Client;

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

$result = $client->workflows()->steps()->get(
    stepId: 'step_abc123',
);
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.GetAsync("step_abc123", new WorkflowStepsGetOptions());
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().get("step_abc123", "run_abc123");
    System.out.println(result);
  }
}

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

{
  "step_id": "step_extract_1",
  "run_id": "run_abc123xyz",
  "block_id": "extract-block-1",
  "block_type": "extract",
  "block_label": "Extract Invoice",
  "lifecycle": { "status": "completed" },
  "started_at": "2026-05-18T10:00:00Z",
  "completed_at": "2026-05-18T10:00:04Z",
  "loop_containers": [],
  "artifact": { "operation": "extraction", "id": "ext_abc123" },
  "retry_count": 0,
  "created_at": "2026-05-18T10:00:00Z",
  "handle_outputs": {
    "output-json-0": {
      "type": "json",
      "data": {
        "invoice_number": "INV-2024-001",
        "total_amount": 1234.56,
        "vendor_name": "Acme Corp"
      }
    }
  },
  "handle_inputs": {
    "input-file-0": {
      "type": "file",
      "document": {
        "id": "file_123",
        "filename": "invoice.pdf",
        "mime_type": "application/pdf"
      }
    }
  },
  "model": null
}

{
  "step_id": "step_extract_1",
  "run_id": "run_abc123xyz",
  "block_id": "extract-block-1",
  "block_type": "extract",
  "block_label": "Extract Invoice",
  "lifecycle": { "status": "error", "message": "Model request failed" },
  "started_at": "2026-05-18T10:00:00Z",
  "completed_at": "2026-05-18T10:00:04Z",
  "loop_containers": [],
  "artifact": null,
  "retry_count": 0,
  "created_at": "2026-05-18T10:00:00Z",
  "handle_outputs": {},
  "handle_inputs": {},
  "model": null
}

{
  "detail": "Step 'step_extract_1' not found"
}