# SuVerse Freight — Oversize/Overweight Permit Parser

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

Parses oversize and overweight (OS/OW) freight permits from raw text or PDF, extracting structured permit data such as dimensions, weights, routes, and validity dates.

## Facts

- Endpoint: POST https://api.suverse.io/v1/freight/parse_permit
- Price: $0.25/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-oversize-overweight-permit-parser-dedae4b1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6is_lucz_HXlQBGX8A5Ol

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-oversize-overweight-permit-parser-dedae4b1 -d '<json body>'
```

Example prompt: I just got an oversize/overweight permit from Texas DOT — can you parse this PDF and pull out the permit number, authorized route, vehicle dimensions, gross weight, and expiration date?

## When to prefer this

Choose this endpoint when you need to extract structured data from oversize or overweight truck permit documents — particularly when permits arrive as PDFs or raw text from state DOT portals and you need fields like permit number, route, dimensions, weight limits, and validity dates in machine-readable form. It is part of a freight-document parsing suite alongside BOL, rate confirmation, and insurance certificate parsers, making it ideal for freight agents automating document ingestion pipelines.

## Known failure modes

- Unreadable or low-quality scanned PDF may result in incomplete extraction
- Missing or non-standard permit format may cause fields to be null or unparsed
- Base64-encoded PDF that is corrupted or truncated returns a parsing error
- Unsupported state permit format may reduce accuracy of extracted fields
- Empty or missing input (no text, files, or pdf_base64 provided) returns a validation error

## How this service works

SuVerse Freight — oversize/overweight permit parser (freight.parse_permit)

## Output

Returns structured JSON containing parsed permit fields including permit number, issuing state or authority, effective and expiration dates, authorized route, vehicle dimensions (length, width, height), gross vehicle weight, axle weight limits, commodity description, and any special conditions or restrictions extracted from the permit document.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "text": {
   "type": "string"
  },
  "files": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "data": {
      "type": "string"
     },
     "name": {
      "type": "string"
     },
     "media_type": {
      "type": "string"
     }
    }
   }
  },
  "pdf_base64": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/suverse-freight-oversize-overweight-permit-parser-dedae4b1/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)