GET /api/v1/screen

Screen vessels against sanctions lists

Up to 50 vessels screened against the OFAC SDN, UK, Canadian and EU lists by identifier: a designation matches when its IMO (or a listed IMO) or its MMSI equals the vessel's. Names are never matched, so no match means no designation carrying that identifier. Each vessel lists its active and past designations with the list's own facts and source link.

1 credit per vesselKey required

Parameters
Name	In	Description
ids(required)	query	Comma list of up to 50 IMO numbers or "mmsi-" identifiers.
lists	query	Comma list of lists to screen: ofac, uk, canada, eu (default all).

Request

curl -H "Authorization: Bearer $SEADAR_API_KEY" \
  https://www.voydar.com/api/v1/screen?ids=9811000,9166778

Response (abridged)

{
  "type": "screen",
  "method": "Identifier match only: …",
  "count": 2,
  "sanctionedCount": 1,
  "data": [
    { "query": "9166778", "imo": 9166778, "name": "…", "sanctioned": true,
      "activeDesignations": [ { "list": "ofac_sdn", "listName": "OFAC SDN list", "program": "…", "listedAt": null, "matchedOn": "imo", "sourceUrl": "…" } ],
      "pastDesignations": [] },
    { "query": "9811000", "imo": 9811000, "name": "EVER GIVEN", "sanctioned": false, "activeDesignations": [], "pastDesignations": [] }
  ],
  "withheld": [],
  "attribution": [ "…" ], "license": [ "…" ], "sources": ["ofac_sdn"]
}