# SuVerse Freight Rate Confirmation Parser

> SuVerse Freight Rate Confirmation Parser is a paid API for AI agents from api.suverse.io, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-15).

Parses freight rate confirmation documents (text or PDF) and extracts structured load, rate, and carrier data

## Facts

- Endpoint: POST https://api.suverse.io/v1/freight/parse_ratecon
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/suverse-freight-rate-confirmation-parser-913676fe
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0406tiTYiFdx5cTZYaTw5

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-rate-confirmation-parser-913676fe -d '<json body>'
```

Example prompt: I just received a rate confirmation PDF from a broker — can you parse it and pull out the load number, pickup and delivery locations, rate, and carrier details? Here's the PDF as base64.

## When to prefer this

Use this endpoint when you need to extract structured data specifically from freight rate confirmation documents (ratecons), as opposed to BOLs, PODs, or other freight paperwork. It is purpose-built for ratecon vocabulary and fields (load number, pay rate, accessorials, broker/carrier contacts), making it more accurate than general-purpose document parsers for this document type. Prefer this over generic OCR or PDF extractors when freight-specific field recognition and structured JSON output are required.

## Known failure modes

- Unreadable or corrupted PDF base64 returns parsing error
- Low-quality scanned PDFs may yield incomplete or missing fields
- Missing required 'mode' or both 'text' and 'pdf_base64' fields returns validation error
- Documents that are not rate confirmations (e.g. BOLs submitted by mistake) may return incorrect or partial extractions
- Rate confirmations with non-standard broker formats may have lower extraction accuracy
- Payment failure returns 402 if USDC balance is insufficient

## How this service works

SuVerse Freight — rate confirmation parser (freight.parse_ratecon)

## Output

Returns structured JSON containing extracted fields from the rate confirmation document, including load number, shipper and consignee details, pickup and delivery addresses and times, agreed freight rate, accessorial charges, carrier/broker contact information, and other ratecon-specific fields parsed from the submitted text or PDF.

## Request schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/suverse-freight-rate-confirmation-parser-913676fe/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)