invoice-parser

A ProAgentStore stateless API tool that extracts structured data from invoice text using Workers AI, and keeps a parse history in a Durable Object for analytics.

Endpoints

Method	Path	Description
GET	/	Health check
POST	/parse	Extract structured fields from invoice text
GET	/history	Recent parses with results (default: last 20)

POST /parse

Request body:

{
"text": "<raw invoice text>"
}

text is the full plain-text content of the invoice (copy-pasted or OCR output). Required.

Response:

{
"id": "uuid",
"parsedAt": "2026-06-06T12:00:00.000Z",
"result": {
"vendor": "Acme Supplies Ltd.",
"invoice_number": "INV-2024-0042",
"date": "2024-03-01",
"due_date": "2024-03-31",
"line_items": [
{ "description": "Widget A x 10", "quantity": 10, "unit_price": 9.99, "amount": 99.90 },
{ "description": "Shipping", "quantity": null, "unit_price": null, "amount": 12.50 }
],
"subtotal": 99.90,
"tax": 11.24,
"total": 123.64,
"currency": "USD"
}
}

All fields are null if the model cannot determine them. line_items is [] when no line items are found.

GET /history

Returns the most recent parses, newest first.

Optional query param: ?limit=<1-100> (default: 20).

{
"records": [
{
"id": "uuid",
"preview": "ACME SUPPLIES LTD\nInvoice #INV-2024-0042...",
"result": { ... },
"inputLength": 843,
"parsedAt": "2026-06-06T12:00:00.000Z"
}
],
"total": 1
}

preview is the first 200 characters of the submitted text.

Authentication

No authentication is required by default. To restrict access, set the API_KEY secret — callers must then include X-Api-Key: <value> on every request.

Secrets

Secret	Required	Description
API_KEY	No	If set, all requests must include X-Api-Key: <value>

Set via wrangler secret put and mirror in Doppler (pags project):

wrangler secret put API_KEY
doppler secrets set API_KEY=<value> --project pags --config prd

Development

pnpm install
pnpm dev

Parse a sample invoice locally:

curl -X POST http://localhost:8787/parse \
-H "Content-Type: application/json" \
-d '{ "text": "ACME SUPPLIES LTD\nInvoice #INV-2024-0042\nDate: March 1, 2024\nDue: March 31, 2024\n\nWidget A x 10 @ $9.99 = $99.90\nShipping = $12.50\n\nSubtotal: $99.90\nTax (10%): $11.24\nTotal: $123.64" }'

Retrieve history:

curl http://localhost:8787/history?limit=5

Deploy

pnpm deploy
# or push to main — GitHub Actions auto-deploys

Extraction model

Uses @cf/meta/llama-3.3-70b-instruct-fp8-fast via Workers AI. The model is prompted to return a strict JSON schema; the response is sanitised and normalised before being returned. If extraction fails, all fields return as null rather than erroring.