# TradepilotUSA Receipt Text Extraction

> TradepilotUSA Receipt Text Extraction is a paid API for AI agents from www.tradepilotusa.com, paid per call via x402, $0.25/call, status unknown (last checked 2026-10-02).

Extracts structured receipt data (merchant, date, line items, tax, total, currency) from raw receipt text supplied by the caller

## Facts

- Endpoint: POST https://www.tradepilotusa.com/api/agent-commerce/v1/services/receipt_text_extraction/execute?utm_source=zero.xyz
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tradepilotusa-receipt-text-extraction-81a68cd9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tW2LMZXhibm5D_Z2xbP0y

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tradepilotusa-receipt-text-extraction-81a68cd9 -d '<json body>'
```

Example prompt: I have the raw text from a hardware store receipt — can you extract the merchant name, date, all line items with quantities and prices, the tax, the total, and the currency from it? Here's the text: 'Example Hardware Store, Dallas | 2026-09-01 | door hinge set x1 $20.00 | Tax: $1.65 | Total: $21.65 USD'

## When to prefer this

Choose this endpoint when you have raw or semi-structured receipt text that needs to be parsed into discrete labeled fields (merchant, date, line items, tax, total, currency) for downstream use in expense management, accounting, or bookkeeping workflows. It is especially well-suited when the receipt text may be incomplete or ambiguous, as the service explicitly surfaces assumptions and evidence gaps rather than silently inferring missing values, making it safer for audit-sensitive contexts.

## Known failure modes

- Source text too short (below 20 characters) — request rejected with validation error
- Source text too long (over 32,000 characters) — request rejected with length error
- Ambiguous or missing fields in source text — reflected in evidence_gaps array and requires_human_review set to true
- Malformed input JSON — 400-level error
- Payment not included or insufficient — 402 Payment Required
- Receipt text in an unsupported format or language — partial extraction with assumptions noted

## How this service works

Extract merchant, date, line items, tax, total, and currency from supplied receipt text; do not infer absent amounts. Uses buyer-supplied information only; no external research or outbound actions. Returns a draft for human review.

## Output

A JSON object containing the task name, a plain-language summary of what was extracted, a formatted artifact with labeled fields (merchant, date, line items with quantity and price, tax, total, currency), provenance metadata (source, timestamp, whether external research was performed), a unique request ID, a list of assumptions made during extraction, identified evidence gaps, and a flag indicating whether human review is recommended.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "brief": {
   "type": "string",
   "maxLength": 12000,
   "minLength": 10
  },
  "audience": {
   "type": "string",
   "maxLength": 500
  },
  "source_text": {
   "type": "string",
   "maxLength": 32000,
   "minLength": 20
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "task": "receipt_text_extraction",
  "summary": "Extracted merchant, date, line items, tax, total, and currency from the supplied fictional receipt text without inferring any missing amounts.",
  "artifact": "Illustrative excerpt from a synthetic provider check:\n### Extracted Receipt Data\n\n- **Merchant:** Example Hardware Store, Dallas\n- **Date:** 2026-09-01\n- **Line Items:**\n  - Item: door hinge set\n  - Quantity: 1\n  - Price: 20 USD\n- **Tax:** 1.65 USD\n- **Total:** 21.65 USD\n- **Currency:** USD\n\n---\n\n*Note: Payment method and customer identity are outside the scope of this extraction.*",
  "provenance": {
   "source": "buyer_supplied",
   "generated_at": "2026-09-22T14:42:48.337Z",
   "external_research_performed": false
  },
  "request_id": "example_receipt_text_extraction",
  "assumptions": [
   "The price of the line item is the unit price as no total line item cost is separately stated.",
   "Currency is USD as explicitly stated with prices, tax, and total."
  ],
  "evidence_gaps": [
   "No additional line items beyond the single door hinge set are provided.",
   "No subtotal amount is given separately from total and tax."
  ],
  "requires_human_review": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tradepilotusa-receipt-text-extraction-81a68cd9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.tradepilotusa.com](https://www.zero.xyz/host/www.tradepilotusa.com/llms.txt)