GET/api/v1/wrecks
Wrecks in an area
Wrecks inside a bounding box as summary rows, in a stable order with cursor pagination: `entityId`, `slug`, `name`, `sunkYear`, `vesselType`, `lat`/`lon` with `position_precision`, `page` (the Voydar wreck page) and `pageIndexed`, `api` (the full record at /api/v1/wrecks/{id}), and `chartedRecords` (NOAA ENC or UKHO record ids linked by identifier or by an accepted match). Each row is served only when its record's source permits API use; charted record ids likewise on their own source. Sensitive-location protection applies exactly as on the wreck page: a wreck whose position is withheld is never listed (nor counted), a generalised one appears only at its display position (a grid-cell centre, `position_precision.kind` = generalised with `precision_km`) and without charted record ids, and a box only ever matches the published position. A page may hold fewer rows than `limit`; follow `next` until it is null. Charted data is not for navigation.
1 creditKey required
| Name | In | Description |
|---|---|---|
| bbox(required) | query | west,south,east,north in WGS 84 degrees; west < east (a box across the antimeridian is two requests), at most 500 square degrees. |
| limit | query | Rows per page, 1 to 500 (default 100). |
| cursor | query | Opaque cursor: use the "next" URL of the previous page. |
curl -H "Authorization: Bearer $VOYDAR_API_KEY" \
https://www.voydar.com/api/v1/wrecks?bbox=-81.6,24.4,-80.0,25.4&limit=2Response (abridged)
{
"type": "port_list",
"apiVersion": "1",
"count": 2,
"data": [
{ "unlocode": "NLAMS", "name": "Amsterdam", "country": "NL", "coordinates": { "lat": 52.4, "lon": 4.82, "source": "unlocode" },
"api": "https://www.voydar.com/api/v1/ports/nlams" },
{ "unlocode": "NLRTM", "name": "Rotterdam", "country": "NL", "coordinates": { "lat": 51.9, "lon": 4.5, "source": "nga_wpi" },
"api": "https://www.voydar.com/api/v1/ports/nlrtm" }
],
"next": "https://www.voydar.com/api/v1/ports?country=NL&limit=2&cursor=NLRTM",
"withheld": [],
"attribution": [ "…" ], "license": [ "…" ], "sources": ["nga_wpi", "unlocode"]
}