{"authority":"The PAYMENT-REQUIRED header on a live 402 response is authoritative.","openapi":"https://api.generalrelay.xyz/.well-known/openapi.json","resources":[{"asset":"USDC","description":"Find vessels by name (substring), IMO (exact), MMSI (exact), and/or spatial bounds. Identity filters (name/imo/mmsi) AND together; spatial is one mode (bbox XOR radius, max 5°×5° or 500 km). At least one filter required; empty call is 400. Returns array of enriched vessel objects (registry, emissions, water_body, chokepoint, warnings), ordered by last_seen DESC, capped at 100. Coverage: terrestrial VHF + AISHub. Charged per non-empty result: empty array, 400, 500, 503 settle nothing.","input":[{"description":"Vessel name, case-insensitive substring match. Leading and trailing whitespace is stripped. Example: name=PACIFIC matches \"PACIFIC ENDEAVOUR\". Combines with spatial and other identity filters.","name":"name","required":false,"type":"string"},{"description":"IMO number, exact match. A seven-digit international ship identifier. ANDs with name/mmsi/spatial filters.","name":"imo","required":false,"type":"integer"},{"description":"The vessel's MMSI, exactly nine decimal digits, e.g. 366123456. Sent as text: leading zeros are significant. ANDs with other identity/spatial filters.","name":"mmsi","required":false,"type":"string"},{"description":"Southern latitude bound in decimal degrees, for bbox mode. Must be between -90 and 90, and less than or equal to lat_max. The span (lat_max - lat_min) must not exceed 5°.","name":"lat_min","required":false,"type":"number"},{"description":"Northern latitude bound in decimal degrees, for bbox mode. Must be between -90 and 90, and greater than or equal to lat_min. The span (lat_max - lat_min) must not exceed 5°.","name":"lat_max","required":false,"type":"number"},{"description":"Western longitude bound in decimal degrees, for bbox mode. Must be between -180 and 180, and less than or equal to lon_max. The span (lon_max - lon_min) must not exceed 5°.","name":"lon_min","required":false,"type":"number"},{"description":"Eastern longitude bound in decimal degrees, for bbox mode. Must be between -180 and 180, and greater than or equal to lon_min. The span (lon_max - lon_min) must not exceed 5°.","name":"lon_max","required":false,"type":"number"},{"description":"Center latitude in decimal degrees, for radius mode. Must be between -90 and 90.","name":"lat","required":false,"type":"number"},{"description":"Center longitude in decimal degrees, for radius mode. Must be between -180 and 180.","name":"lon","required":false,"type":"number"},{"description":"Search radius in kilometers, for radius mode. Must be between 0.1 and 500.","name":"radius_km","required":false,"type":"number"}],"maxAmountRequired":"20000","method":"GET","mimeType":"application/json","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","output":{"example":[{"call_sign":"MDZK7","dimensions":{"beam":32,"bow":172,"length":200,"port":16,"starboard":16,"stern":28},"emissions":null,"first_seen":"2026-06-02T09:14:03Z","imo_number":9394521,"last_seen":"2026-08-10T14:03:53Z","mmsi":"232004521","name":"PACIFIC ENDEAVOUR","navigational_warnings":null,"nearest_chokepoint":null,"position":{"age_seconds":12,"course_over_ground":94.2,"heading":96,"latitude":51.4482,"longitude":0.7361,"msg_type":1,"nav_status":0,"speed_over_ground":11.4,"time":"2026-08-10T14:03:53Z"},"registry":null,"ship_type":70,"water_body":null}]},"priceUsd":0.02,"resource":"https://api.generalrelay.xyz/v1/vessels","scheme":"x402-exact","summary":"Search vessels by identity, location, or both"}],"x402Version":2}