Node.js

import { Parsefy } from 'parsefy';
import * as z from 'zod';

const client = new Parsefy('pk_your_api_key');

const schema = z.object({
  vendor: z.string().describe('Merchant or store name'),
  total: z.number().describe('Total amount paid'),
  purchase_date: z.string().describe('Purchase date in YYYY-MM-DD format'),
});

const { object } = await client.extract({
  file: './receipt.pdf',
  schema,
});

console.log(object);
// { vendor: "Cafe Mason", total: 32.59, purchase_date: "2023-08-29" }

export PARSEFY_API_KEY=pk_your_api_key

import { Parsefy } from 'parsefy';
import * as z from 'zod';

const client = new Parsefy(); // If not explicitly provided, Parsefy will try to get PARSEFY_API_KEY from environment variables

const schema = z.object({
  // REQUIRED - triggers fallback if below confidence threshold
  invoice_number: z.string().describe('The invoice number'),
  total: z.number().describe('Total amount including tax'),

  // OPTIONAL - won't trigger fallback if missing or low confidence
  vendor: z.string().optional().describe('Vendor name'),
  due_date: z.string().optional().describe('Payment due date'),
});

const { object, metadata, verification, error } = await client.extract({
  file: './invoice.pdf',
  schema,
  enableVerification: true, // Enable math verification
});

if (!error && object) {
  console.log(object.invoice_number); // Fully typed!

  // Access field-level confidence from _meta
  console.log(`Overall confidence: ${object._meta.confidence_score}`);
  object._meta.field_confidence.forEach((fc) => {
    console.log(`${fc.field}: ${fc.score} (${fc.reason}) - "${fc.text}"`);
  });

  // Check verification results
  if (verification) {
    console.log(`Verification: ${verification.status}`);
  }
}

const { object, metadata } = await client.extract({
  file: './invoice.pdf',
  schema,
  confidenceThreshold: 0.85, // default
});