Schema

from retab import Retab

client = Retab()

schema = client.schemas.generate(
documents=[
"freight/booking_confirmation_1.jpg",
"freight/booking_confirmation_2.jpg",
],
model="retab-small",
instructions="Capture shipment dates, parties, and reference numbers.",
)

print(schema.json_schema)

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

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

const schema = await client.schemas.generate([
    "freight/booking_confirmation_1.jpg",
    "freight/booking_confirmation_2.jpg",
  ], "retab-small", "Capture shipment dates, parties, and reference numbers.");

console.log(schema.jsonSchema);

package main

import (
	"context"
	"fmt"
	"log"

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

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

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

	firstDocument, err := retab.InferMIMEData("freight/booking_confirmation_1.jpg")
	if err != nil {
		log.Fatal(err)
	}
	secondDocument, err := retab.InferMIMEData("freight/booking_confirmation_2.jpg")
	if err != nil {
		log.Fatal(err)
	}

	model := "retab-small"
	schema, err := client.Schemas.Generate(ctx, &retab.SchemasGenerateParams{
		Documents: []any{firstDocument, secondDocument},
		Model:     &model,
	})
	if err != nil {
		log.Fatal(err)
	}

	fmt.Println(schema.JSONSchema)
}

require 'retab'

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

schema = client.schemas.generate(
  documents: [
    'freight/booking_confirmation_1.jpg',
    'freight/booking_confirmation_2.jpg',
  ],
  model: 'retab-small',
  instructions: 'Capture shipment dates, parties, and reference numbers.',
)

puts schema.json_schema

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

use Retab\Client;

$client = new Client();

$schema = $client->schemas()->generate(
    documents: [
        'freight/booking_confirmation_1.jpg',
        'freight/booking_confirmation_2.jpg',
    ],
    model: 'retab-small',
    instructions: 'Capture shipment dates, parties, and reference numbers.',
);

print_r($schema->jsonSchema);

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.schemas().generate(null, "retab-1.5", "Extract the invoice fields", null);
    System.out.println(result);
  }
}

curl https://api.retab.com/v1/schemas/generate \
  -H "Authorization: Bearer $RETAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "documents": [
      {
        "filename": "booking_confirmation_1.jpg",
        "url": "data:image/jpeg;base64,..."
      },
      {
        "filename": "booking_confirmation_2.jpg",
        "url": "data:image/jpeg;base64,..."
      }
    ],
    "model": "retab-small",
    "instructions": "Capture shipment dates, parties, and reference numbers."
  }'

{
  "object": "schema",
  "created_at": "2026-05-13T12:00:00Z",
  "json_schema": {
    "type": "object",
    "properties": {
      "booking_reference": {
        "type": "string",
        "description": "The booking or shipment reference number."
      },
      "departure_date": {
        "type": "string",
        "description": "The scheduled departure date."
      }
    },
    "required": ["booking_reference", "departure_date"]
  },
  "strict": true
}

using System;
using System.Collections.Generic;
using System.IO;
using System.Threading.Tasks;
using Retab;
using RetabClient = Retab.Retab;

var client = new RetabClient("YOUR_API_KEY");

var schema = await client.Schemas.GenerateAsync(
    new SchemasGenerateOptions
    {
        Documents = new List<MimeData>
        {
            new FileInfo("freight/booking_confirmation_1.jpg"),
            new FileInfo("freight/booking_confirmation_2.jpg"),
        },
        Model = "retab-small",
        Instructions = "Capture shipment dates, parties, and reference numbers.",
    }
);

Console.WriteLine(schema.JsonSchema);

use retab::{resources::schemas::GenerateParams, Retab};

let client = Retab::new(std::env::var("RETAB_API_KEY")?);
let schema = client
    .schemas()
    .generate(GenerateParams::new([
        "freight/booking_confirmation_1.jpg",
        "freight/booking_confirmation_2.jpg",
    ]))
    .await?;

println!("{:#?}", schema.json_schema);