{"info":{"description":"Pay-per-call US government, freight and logistics APIs. Call any paid endpoint without payment to receive a 402 challenge carrying price, chain and payTo, then retry the same request with the X-PAYMENT header.","title":"SuVerse GovHub \u2014 x402 API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/health":{"get":{"operationId":"health","responses":{"200":{"description":"OK"}},"summary":"Liveness probe."}},"/v1/freight/calculate_tolls":{"post":{"description":"SuVerse Freight \u2014 offline toll estimator (freight.calculate_tolls). $0.10 USDC per call. Call without a payment header to receive the 402 challenge (price, chain, payTo), then retry with X-PAYMENT.","operationId":"freight_calculate_tolls","requestBody":{"content":{"application/json":{"example":{"axles":5,"height_ft":13.5,"polyline":"<encoded polyline6 string OR array of [lat, lon] points>","toll_maneuvers":[]},"schema":{"type":"object"}}},"required":true},"responses":{"200":{"description":"Result payload."},"402":{"description":"Payment required \u2014 body carries the x402 challenge."}},"summary":"SuVerse Freight \u2014 offline toll estimator (freight.calculate_tolls)"}},"/v1/freight/get_load_position":{"post":{"description":"SuVerse Logistics \u2014 get a tracked load's current position (logistics.get_load_position). $0.02 USDC per call. Call without a payment header to receive the 402 challenge (price, chain, payTo), then retry with X-PAYMENT.","operationId":"logistics_get_load_position","requestBody":{"content":{"application/json":{"example":{"loadNumber":"LD-2026-1234"},"schema":{"type":"object"}}},"required":true},"responses":{"200":{"description":"Result payload."},"402":{"description":"Payment required \u2014 body carries the x402 challenge."}},"summary":"SuVerse Logistics \u2014 get a tracked load's current position (logistics.get_load_position)"}},"/v1/freight/parse_bol_pod":{"post":{"description":"SuVerse Freight \u2014 BOL/POD parser (freight.parse_bol_pod). $0.15 USDC per call. Call without a payment header to receive the 402 challenge (price, chain, payTo), then retry with X-PAYMENT.","operationId":"freight_parse_bol_pod","requestBody":{"content":{"application/json":{"example":{"mode":"llm","pdf_base64":"<base64-encoded BOL/POD PDF>","text":"<raw BOL/POD text (alternative to pdf_base64)>"},"schema":{"type":"object"}}},"required":true},"responses":{"200":{"description":"Result payload."},"402":{"description":"Payment required \u2014 body carries the x402 challenge."}},"summary":"SuVerse Freight \u2014 BOL/POD parser (freight.parse_bol_pod)"}},"/v1/freight/parse_fuel_receipt":{"post":{"description":"SuVerse Freight \u2014 fuel receipt parser (freight.parse_fuel_receipt). $0.05 USDC per call. Call without a payment header to receive the 402 challenge (price, chain, payTo), then retry with X-PAYMENT.","operationId":"freight_parse_fuel_receipt","requestBody":{"content":{"application/json":{"example":{"image_base64":"<base64-encoded receipt image (alternative)>","mode":"auto","pdf_base64":"<base64-encoded receipt PDF (alternative)>","text":"<raw fuel receipt text>"},"schema":{"type":"object"}}},"required":true},"responses":{"200":{"description":"Result payload."},"402":{"description":"Payment required \u2014 body carries the x402 challenge."}},"summary":"SuVerse Freight \u2014 fuel receipt parser (freight.parse_fuel_receipt)"}},"/v1/freight/parse_insurance_cert":{"post":{"description":"SuVerse Freight \u2014 Certificate of Insurance parser (freight.parse_insurance_cert). $0.08 USDC per call. Call without a payment header to receive the 402 challenge (price, chain, payTo), then retry with X-PAYMENT.","operationId":"freight_parse_insurance_cert","requestBody":{"content":{"application/json":{"example":{"image_base64":"<base64-encoded COI image (alternative)>","mode":"auto","pdf_base64":"<base64-encoded COI PDF (alternative)>","text":"<raw ACORD 25 certificate text>"},"schema":{"type":"object"}}},"required":true},"responses":{"200":{"description":"Result payload."},"402":{"description":"Payment required \u2014 body carries the x402 challenge."}},"summary":"SuVerse Freight \u2014 Certificate of Insurance parser (freight.parse_insurance_cert)"}},"/v1/freight/parse_permit":{"post":{"description":"SuVerse Freight \u2014 oversize/overweight permit parser (freight.parse_permit). $0.25 USDC per call. Call without a payment header to receive the 402 challenge (price, chain, payTo), then retry with X-PAYMENT.","operationId":"freight_parse_permit","requestBody":{"content":{"application/json":{"example":{"files":[{"data":"<base64 PDF/image>","media_type":"application/pdf","name":"permit.pdf"}],"pdf_base64":"<base64-encoded permit PDF (alternative to files[])>","text":"<raw permit text (alternative)>"},"schema":{"type":"object"}}},"required":true},"responses":{"200":{"description":"Result payload."},"402":{"description":"Payment required \u2014 body carries the x402 challenge."}},"summary":"SuVerse Freight \u2014 oversize/overweight permit parser (freight.parse_permit)"}},"/v1/freight/parse_ratecon":{"post":{"description":"SuVerse Freight \u2014 rate confirmation parser (freight.parse_ratecon). $0.10 USDC per call. Call without a payment header to receive the 402 challenge (price, chain, payTo), then retry with X-PAYMENT.","operationId":"freight_parse_ratecon","requestBody":{"content":{"application/json":{"example":{"mode":"llm","pdf_base64":"<base64-encoded rate confirmation PDF>","text":"<raw rate confirmation text (alternative to pdf_base64)>"},"schema":{"type":"object"}}},"required":true},"responses":{"200":{"description":"Result payload."},"402":{"description":"Payment required \u2014 body carries the x402 challenge."}},"summary":"SuVerse Freight \u2014 rate confirmation parser (freight.parse_ratecon)"}},"/v1/freight/parse_w9":{"post":{"description":"SuVerse Freight \u2014 IRS W-9 parser (freight.parse_w9). $0.07 USDC per call. Call without a payment header to receive the 402 challenge (price, chain, payTo), then retry with X-PAYMENT.","operationId":"freight_parse_w9","requestBody":{"content":{"application/json":{"example":{"image_base64":"<base64-encoded W-9 image (alternative)>","mode":"auto","pdf_base64":"<base64-encoded W-9 PDF (alternative)>","text":"<raw W-9 text>"},"schema":{"type":"object"}}},"required":true},"responses":{"200":{"description":"Result payload."},"402":{"description":"Payment required \u2014 body carries the x402 challenge."}},"summary":"SuVerse Freight \u2014 IRS W-9 parser (freight.parse_w9)"}},"/v1/freight/trip_telematics":{"post":{"description":"SuVerse Freight \u2014 GPS trip analytics (freight.trip_telematics). $0.01 USDC per call. Call without a payment header to receive the 402 challenge (price, chain, payTo), then retry with X-PAYMENT.","operationId":"freight_trip_telematics","requestBody":{"content":{"application/json":{"example":{"options":{"assumed_mpg":6.5,"fuel_price":4.0},"pings":[{"fuelRateGph":0.8,"lat":41.8781,"lon":-87.6298,"speed":0,"timestamp":"2026-05-20T14:00:00Z"},{"fuelRateGph":6.4,"lat":41.7,"lon":-88.0,"speed":62,"timestamp":"2026-05-20T14:30:00Z"}]},"schema":{"type":"object"}}},"required":true},"responses":{"200":{"description":"Result payload."},"402":{"description":"Payment required \u2014 body carries the x402 challenge."}},"summary":"SuVerse Freight \u2014 GPS trip analytics (freight.trip_telematics)"}},"/v1/freight/truck_route":{"post":{"description":"SuVerse Freight \u2014 truck routing with tolls & POIs (freight.truck_route). $0.50 USDC per call. Call without a payment header to receive the 402 challenge (price, chain, payTo), then retry with X-PAYMENT.","operationId":"freight_truck_route","requestBody":{"content":{"application/json":{"example":{"destination":{"address":"Dallas, TX"},"include_truck_stops":true,"include_weigh_stations":true,"origin":{"lat":41.8781,"lon":-87.6298},"truck":{"axles":5,"hazmat":false,"height_ft":13.5,"weight_lbs":80000},"via_points":[]},"schema":{"type":"object"}}},"required":true},"responses":{"200":{"description":"Result payload."},"402":{"description":"Payment required \u2014 body carries the x402 challenge."}},"summary":"SuVerse Freight \u2014 truck routing with tolls & POIs (freight.truck_route)"}},"/v1/gov":{"post":{"description":"SuVerse GovHub \u2014 pay-per-call government API gateway. $0.005 USDC per call. Call without a payment header to receive the 402 challenge (price, chain, payTo), then retry with X-PAYMENT.","operationId":"gov_dispatch","requestBody":{"content":{"application/json":{"example":{"params":{"ticker":"AAPL"},"service":"sec.company_info"},"schema":{"type":"object"}}},"required":true},"responses":{"200":{"description":"Result payload."},"402":{"description":"Payment required \u2014 body carries the x402 challenge."}},"summary":"SuVerse GovHub \u2014 pay-per-call government API gateway"}},"/v1/gov/cms_open_payments":{"post":{"description":"SuVerse GovHub \u2014 CMS Open Payments (cms.open_payments). $0.01 USDC per call. Call without a payment header to receive the 402 challenge (price, chain, payTo), then retry with X-PAYMENT.","operationId":"cms_open_payments","requestBody":{"content":{"application/json":{"example":{"params":{"physician_npi":"1234567890","year":2023}},"schema":{"type":"object"}}},"required":true},"responses":{"200":{"description":"Result payload."},"402":{"description":"Payment required \u2014 body carries the x402 challenge."}},"summary":"SuVerse GovHub \u2014 CMS Open Payments (cms.open_payments)"}},"/v1/gov/fbi_crime_data":{"post":{"description":"SuVerse GovHub \u2014 FBI Crime Data Explorer (fbi.crime_data). $0.01 USDC per call. Call without a payment header to receive the 402 challenge (price, chain, payTo), then retry with X-PAYMENT.","operationId":"fbi_crime_data","requestBody":{"content":{"application/json":{"example":{"params":{"from_year":2018,"offense":"violent-crime","state":"TX","to_year":2022}},"schema":{"type":"object"}}},"required":true},"responses":{"200":{"description":"Result payload."},"402":{"description":"Payment required \u2014 body carries the x402 challenge."}},"summary":"SuVerse GovHub \u2014 FBI Crime Data Explorer (fbi.crime_data)"}},"/v1/gov/services":{"get":{"operationId":"list_services","responses":{"200":{"description":"Service catalog with live prices."}},"summary":"List every service callable through POST /v1/gov."}}},"servers":[{"url":"https://api.suverse.io"}]}