# SuVerse Freight — IRS W-9 Parser

> SuVerse Freight — IRS W-9 Parser is a paid API for AI agents from api.suverse.io, paid per call via x402, $0.07/call, status unknown (last checked 2026-09-14).

Extracts structured tax identity fields from IRS W-9 forms submitted as raw text, PDF, or image

## Facts

- Endpoint: POST https://api.suverse.io/v1/freight/parse_w9
- Price: $0.07/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suverse-freight-irs-w-9-parser-5838c3f2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jM0Hx244xwtWLY9qNS6hB

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 suverse-freight-irs-w-9-parser-5838c3f2 -d '<json body>'
```

Example prompt: I just received a W-9 from a new carrier — here's the PDF. Can you parse it and pull out their legal name, EIN, tax classification, and address so I can add them to our system?

## When to prefer this

Use this endpoint when you need to automate ingestion of IRS W-9 forms in a freight or logistics context, particularly for carrier onboarding or accounts payable workflows. It supports text, PDF, and image inputs making it versatile for fax, scan, or digital submissions. Prefer this over general-purpose OCR when you need freight-domain-aware W-9 field extraction with structured output, and over manual data entry when processing high volumes of carrier tax documents.

## Known failure modes

- Unreadable or low-quality image results in incomplete field extraction
- PDF not properly base64-encoded causes parse failure
- Missing or ambiguous mode parameter may yield unexpected parsing path
- Form is not a W-9 (e.g., W-8, 1099) and fields don't map correctly
- Handwritten forms with poor legibility may produce incorrect EIN or name values

## How this service works

SuVerse Freight — IRS W-9 parser (freight.parse_w9)

## Output

Structured JSON object containing extracted W-9 fields such as taxpayer legal name, federal tax classification (individual/sole proprietor, LLC, C-corp, S-corp, partnership, etc.), EIN or SSN, exempt payee code, FATCA exemption code, address, and any signature/date indicators detected in the document.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "type": "string"
  },
  "text": {
   "type": "string"
  },
  "pdf_base64": {
   "type": "string"
  },
  "image_base64": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/suverse-freight-irs-w-9-parser-5838c3f2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.suverse.io](https://www.zero.xyz/host/api.suverse.io/llms.txt)