Extract & Poll

Extraction is asynchronous. When you submit a document for extraction, Tracore creates a run and returns immediately with a 202 status and a run ID. You then poll the run until it reaches a terminal status.

Start extraction

const run = await client.extract("my-workspace", "invoice", {
  documentId: "doc_abc123",
});

console.log(run.id); // "run_xyz789"
console.log(run.status); // "pending"

Auto-polling

Pass poll: true to have the SDK automatically poll until the run completes or fails:

const run = await client.extract("my-workspace", "invoice", {
  documentId: "doc_abc123",
  poll: true,
});

// Resolves only when the run reaches a terminal status
console.log(run.status); // "completed"
console.log(run.result); // extracted data

Custom poll options

Control the polling interval and timeout:

const run = await client.extract("my-workspace", "invoice", {
  documentId: "doc_abc123",
  poll: true,
  pollIntervalMs: 2000, // check every 2 seconds (default: 1000)
  pollTimeoutMs: 120000, // give up after 2 minutes (default: 60000)
});

Manual polling

If you prefer to control the polling loop yourself:

const run = await client.extract("my-workspace", "invoice", {
  documentId: "doc_abc123",
});

let result = run;

while (result.status === "pending" || result.status === "processing") {
  await new Promise((resolve) => setTimeout(resolve, 1000));
  result = await client.runs.get(result.id);
}

if (result.status === "completed") {
  console.log(result.result);
} else {
  console.error("Extraction failed:", result.error);
}

Inline upload and extract

You can upload a file and start extraction in one request:

import { readFileSync } from "node:fs";

const file = new Blob([readFileSync("./invoice.pdf")], {
  type: "application/pdf",
});

const run = await client.extract("my-workspace", "invoice", {
  file,
  fileName: "invoice.pdf",
  poll: true,
});

Run statuses

Error handling

try {
  const run = await client.extract("my-workspace", "invoice", {
    documentId: "doc_abc123",
    poll: true,
  });

  if (run.status === "completed") {
    console.log(run.result);
  } else if (run.status === "validation_failed") {
    console.error("Validation failed:", run.error);
  } else {
    console.error("Extraction failed:", run.error);
  }
} catch (error) {
  // Network or timeout errors
  console.error("Request failed:", error);
}