Skip to content
Developer docs: all pages

GET/api/v1/trade/sources

Trade, commodity and freight data sources

Every trade, commodity and freight dataset Voydar tracks, with its publisher, licence, required attribution, update cadence, newest data period and last successful load. A source whose rights do not allow API use, or that Voydar holds pending a rights decision, is listed with `exposed: false` and the reason, and none of its content is served. Registered is not loaded: read each source's newest period and last load here before relying on it (US Census and the EIA API v2 series are registered and may hold nothing yet; Eurostat Comext, Statistics Canada, BLS and BTS are loaded monthly and lag their reference month by several weeks). Free (0 credits). These are reported government statistics, each series with its source and licence; nothing here is a voyage model or an estimate of what a ship carries. Sources withheld for rights reasons are listed as withheld with the reason, and no plan unlocks them. Available on every API plan, including the free Sandbox. A server-side release switch is checked on every request: while it is off for your account this endpoint answers 404 (not_found), free.

FreeKey required

Request
curl -H "Authorization: Bearer $VOYDAR_API_KEY" \
  https://www.voydar.com/api/v1/trade/sources
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"]
}