{"uid":"cap_iQSAed7A6xjWR7MP1-Ev3","slug":"general-relay-vessel-search-api-544228bc","name":"General Relay Vessel Search API","description":"Search vessels by identity, location, or both. Charged per non-empty result: empty array, 400, 500, 503 settle nothing.","url":"https://api.generalrelay.xyz/v1/vessels","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"imo":{"type":"integer","description":"IMO number, exact match. A seven-digit international ship identifier. ANDs with name/mmsi/spatial filters."},"lat":{"type":"number","description":"Center latitude in decimal degrees, for radius mode. Must be between -90 and 90."},"lon":{"type":"number","description":"Center longitude in decimal degrees, for radius mode. Must be between -180 and 180."},"mmsi":{"type":"string","pattern":"^[0-9]{9}$","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":{"type":"string","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."},"lat_max":{"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°."},"lat_min":{"type":"number","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°."},"lon_max":{"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°."},"lon_min":{"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°."},"radius_km":{"type":"number","description":"Search radius in kilometers, for radius mode. Must be between 0.1 and 500."}}}},"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lfyKiXUdgvDeQQbrzuViJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search for vessels by identity (name, IMO, MMSI) and/or location (bounding box or radius), returning matching AIS vessel records.","exampleAgentPrompt":"Can you find any vessels with 'PACIFIC' in their name that are currently near latitude 37.8 and longitude -122.4, within a 10-nautical-mile radius?","exampleUseCases":[{"title":"Identify ship by IMO number","prompt":"Look up the vessel with IMO number 9074729 and tell me its current name and position."},{"title":"Find vessels in port area","prompt":"Search for all ships currently within the bounding box around the Port of Rotterdam — roughly lat 51.88 to 51.93, lon 4.0 to 4.1 — and list what you find."},{"title":"Locate vessel by MMSI","prompt":"I need to find the ship with MMSI 366123456 — can you pull up whatever identity and location data is available for it?"}],"resultDescription":"An array of vessel records matching the query filters, each containing vessel identity fields (name, IMO, MMSI) and current or last-known position data (latitude, longitude). Returns an empty array if no matches are found. Charges apply only when the result array is non-empty.","failureModes":["400 Bad Request: invalid parameter values (e.g. lat/lon out of range, bounding box span exceeds 5°, malformed MMSI)","500 Internal Server Error: server-side failure, no charge applied","503 Service Unavailable: service temporarily down, no charge applied","Empty array returned when no vessels match the filters — no charge applied","Missing required query filter — must supply at least one of name, IMO, MMSI, or spatial parameters"],"whenToPreferThis":"Use this endpoint when you need to search maritime vessel data by identity (name, IMO, MMSI) or by geographic area (bounding box up to 5°×5° or radius). Prefer it for agent workflows that need to resolve a vessel identifier to current position, or enumerate vessels in a specific maritime zone. Note that charges only apply on non-empty results, making it safe to probe.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:35:45.615Z","isFirstParty":false}