Skip to content

← Endpoint reference

GET /api/v1/sanctions/{list}

Vessels designated on a sanctions list

Every vessel currently designated on one list, with the list's own facts (listed name, IMO, MMSI, flag, programme, designation date, source link). What Voydar observed since (positions, port calls) is not included.

1 creditKey required

Parameters
NameInDescription
list(required)pathofac, uk, canada, eu or new-zealand.
limitqueryRows per page, 1 to 100 (default 50).
cursorqueryOpaque cursor: use the "next" URL of the previous page.
Request
curl -H "Authorization: Bearer $SEADAR_API_KEY" \
  https://www.voydar.com/api/v1/sanctions/ofac?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"]
}