veryfi-documents-ai

# Documents AI by Veryfi

Real-time OCR and data extraction API — extract structured data from receipts, invoices, bank statements, W-9s, purchase orders, and more, with document classification, fraud detection, and raw OCR text output.

> **Get your API key:** https://app.veryfi.com/api/settings/keys/
> **Learn more:** https://veryfi.com

## Quick Start

For Receipts and Invoices:
```bash
curl -X POST "https://api.veryfi.com/api/v8/partner/documents/" \
  -H "Content-Type: multipart/form-data" \
  -H "Client-Id: $VERYFI_CLIENT_ID" \
  -H "Authorization: apikey $VERYFI_USERNAME:$VERYFI_API_KEY" \
  -F "file=@invoice.pdf"
```

Response:
```json
{
  "id": 62047612,
  "created_date": "2026-02-19",
  "currency_code": "USD",
  "date": "2026-02-18 14:22:00",
  "document_type": "receipt",
  "category": "Meals & Entertainment",
  "is_duplicate": false,
  "vendor": {
    "name": "Starbucks",
    "address": "123 Main St, San Francisco, CA 94105"
  },
  "line_items": [
    {
      "id": 1,
      "order": 0,
      "description": "Caffe Latte Grande",
      "quantity": 1,
      "price": 5.95,
      "total": 5.95,
      "type": "food"
    }
  ],
  "subtotal": 5.95,
  "tax": 0.52,
  "total": 6.47,
  "payment": {
    "type": "visa",
    "card_number": "1234"
  },
  "ocr_text": "STARBUCKS\n123 Main St...",
  "img_url": "https://scdn.veryfi.com/documents/...",
  "pdf_url": "https://scdn.veryfi.com/documents/..."
}
```

For Bank Statements:
```bash
curl -X POST "https://api.veryfi.com/api/v8/partner/bank-statements/" \
  -H "Content-Type: multipart/form-data" \
  -H "Client-Id: $VERYFI_CLIENT_ID" \
  -H "Authorization: apikey $VERYFI_USERNAME:$VERYFI_API_KEY" \
  -F "file=@bank-statement.pdf"
```

Response:
```json
{
  "id": 4820193,
  "created_date": "2026-02-19T12:45:00.000000Z",
  "bank_name": "Chase",
  "bank_address": "270 Park Avenue, New York, NY 10017",
  "account_holder_name": "Jane Doe",
  "account_holder_address": "456 Oak Ave, San Francisco, CA 94110",
  "account_number":...

# Veryfi Documents AI - OpenClaw Skill

[![OpenClaw Skill](https://img.shields.io/badge/OpenClaw-Skill-blue)](https://openclaw.com)
[![Veryfi](https://img.shields.io/badge/Powered%20by-Veryfi-green)](https://www.veryfi.com)

Real-time OCR and data extraction API for AI agents. Extract structured data from receipts, invoices, bank statements, checks, W-9s, passports, and 30+ other document types — with document classification and fraud detection built in.

## Features

- **Receipt & Invoice Extraction** — vendor, line items, totals, tax, payment method, and more
- **Bank Statement Parsing** — account details, balances, and full transaction history
- **Check Processing** — payer/receiver info, MICR data, endorsement detection
- **Document Classification** — identify document type before extraction (15 built-in types + custom)
- **Fraud Detection** — fraud scoring on receipts, invoices, checks, and bank statements
- **30+ Document Blueprints** — passports, driver's licenses, insurance cards, bills of lading, and more via the Any Document endpoint
- **Bounding Boxes & Confidence Scores** — per-field coordinates and accuracy scores

## Prerequisites

Sign up and grab your API credentials at **https://app.veryfi.com/api/settings/keys/**

You'll need three values:

| Variable | Description |
|----------|-------------|
| `VERYFI_CLIENT_ID` | Your application's client ID |
| `VERYFI_USERNAME` | Your Veryfi account username |
| `VERYFI_API_KEY` | Your API key |

## Installation

### npm (recommended)

```bash
npm install veryfi-documents-ai
```

### Manual

Clone this repository and place the `SKILL.md` file in your OpenClaw skills directory.

## Configuration

### Environment Variables (recommended)

```bash
export VERYFI_CLIENT_ID="your_client_id_here"
export VERYFI_USERNAME="your_username_here"
export VERYFI_API_KEY="your_api_key_here"
```

### OpenClaw Config

```json5
{
  skills: {
    entries: {
      "veryfi-documents-ai": {
        enabled: true,
        // Keys loade...