Skip to content
Developer docs: all pages

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

Parameters
NameInDescription
bbox(required)querywest,south,east,north in WGS 84 degrees; west < east (a box across the antimeridian is two requests), at most 500 square degrees.
limitqueryRows per page, 1 to 500 (default 100).
cursorqueryOpaque cursor: use the "next" URL of the previous page.
Request
curl -H "Authorization: Bearer $VOYDAR_API_KEY" \
  https://www.voydar.com/api/v1/wrecks?bbox=-81.6,24.4,-80.0,25.4&limit=2
Response (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"]
}