{
  "opencollection": "1.0.0",
  "info": {
    "name": "Datalastic Maritime API",
    "version": "v0"
  },
  "request": {
    "auth": {
      "type": "apikey",
      "key": "api-key",
      "value": "{{apiKey}}",
      "in": "query"
    }
  },
  "items": [
    {
      "info": {
        "name": "Live Tracking",
        "type": "folder"
      },
      "items": [
        {
          "info": { "name": "Basic live ship tracking.", "type": "http" },
          "http": {
            "method": "GET",
            "url": "https://api.datalastic.com/api/v0/vessel",
            "params": [
              { "name": "uuid", "value": "", "type": "query", "description": "Datalastic vessel UUID." },
              { "name": "mmsi", "value": "566093000", "type": "query", "description": "Vessel MMSI (9-digit)." },
              { "name": "imo", "value": "", "type": "query", "description": "Vessel IMO number (7-digit)." }
            ]
          },
          "docs": "Latest real-time AIS data for one vessel - position, speed, course, heading, navigational status, destination, timestamp. 1 credit per request."
        },
        {
          "info": { "name": "Pro live ship tracking with ETA.", "type": "http" },
          "http": {
            "method": "GET",
            "url": "https://api.datalastic.com/api/v0/vessel_pro",
            "params": [
              { "name": "uuid", "value": "", "type": "query", "description": "Datalastic vessel UUID." },
              { "name": "mmsi", "value": "", "type": "query", "description": "Vessel MMSI." },
              { "name": "imo", "value": "9525338", "type": "query", "description": "Vessel IMO number." }
            ]
          },
          "docs": "Everything /vessel returns plus ETA, actual time of departure, current draft, and UN/LOCODE destination/departure ports. 1 credit per request."
        },
        {
          "info": { "name": "Bulk live ship tracking.", "type": "http" },
          "http": {
            "method": "GET",
            "url": "https://api.datalastic.com/api/v0/vessel_bulk",
            "params": [
              { "name": "mmsi", "value": "566093000", "type": "query", "description": "Repeatable vessel MMSI." },
              { "name": "imo", "value": "9249403", "type": "query", "description": "Repeatable vessel IMO number." }
            ]
          },
          "docs": "Track up to 100 vessels per call by repeating uuid/mmsi/imo parameters. 1 credit per successfully returned vessel."
        }
      ]
    },
    {
      "info": {
        "name": "Zone Traffic",
        "type": "folder"
      },
      "items": [
        {
          "info": { "name": "Vessels within a radius.", "type": "http" },
          "http": {
            "method": "GET",
            "url": "https://api.datalastic.com/api/v0/vessel_inradius",
            "params": [
              { "name": "lat", "value": "29.15915", "type": "query", "description": "Latitude of the center point. Requires lon." },
              { "name": "lon", "value": "-89.25454", "type": "query", "description": "Longitude of the center point. Requires lat." },
              { "name": "radius", "value": "3", "type": "query", "description": "Radius in nautical miles (max 50)." },
              { "name": "port_uuid", "value": "", "type": "query", "description": "Port UUID as center point (alternative to lat/lon)." },
              { "name": "port_unlocode", "value": "", "type": "query", "description": "Port UN/LOCODE as center point." },
              { "name": "type", "value": "", "type": "query", "description": "Vessel type filter." },
              { "name": "type_specific", "value": "", "type": "query", "description": "Vessel subtype filter." },
              { "name": "exclude", "value": "", "type": "query", "description": "Vessel types to exclude." },
              { "name": "nav_status", "value": "", "type": "query", "description": "Numeric navigational status filter." }
            ]
          },
          "docs": "All vessels within a radius (max 50 NM) around coordinates, a port, or a moving vessel (uuid/mmsi/imo). 1 credit per vessel found (max 500)."
        },
        {
          "info": { "name": "Historical vessel traffic within a radius.", "type": "http" },
          "http": {
            "method": "GET",
            "url": "https://api.datalastic.com/api/v0/inradius_history",
            "params": [
              { "name": "lat", "value": "29.15915", "type": "query", "description": "Latitude of the zone center point." },
              { "name": "lon", "value": "-89.25454", "type": "query", "description": "Longitude of the zone center point." },
              { "name": "radius", "value": "3", "type": "query", "description": "Radius in nautical miles (max 50)." },
              { "name": "days", "value": "2", "type": "query", "description": "Days back from today. Alternatively from/to dates." }
            ]
          },
          "docs": "Replays past vessel traffic for a zone. Cost is days multiplied by vessels per day (max 500 vessels/day)."
        }
      ]
    },
    {
      "info": {
        "name": "Historical",
        "type": "folder"
      },
      "items": [
        {
          "info": { "name": "Historical vessel track.", "type": "http" },
          "http": {
            "method": "GET",
            "url": "https://api.datalastic.com/api/v0/vessel_history",
            "params": [
              { "name": "mmsi", "value": "566093000", "type": "query", "description": "Vessel MMSI. Alternatively uuid or imo." },
              { "name": "days", "value": "5", "type": "query", "description": "Days back from today." },
              { "name": "from", "value": "", "type": "query", "description": "Start date YYYY-MM-DD (max 31 days from this date)." },
              { "name": "to", "value": "", "type": "query", "description": "End date YYYY-MM-DD." }
            ]
          },
          "docs": "Past AIS positions for a vessel. 1 credit per vessel per day of data; maximum 31 days from the from date."
        }
      ]
    },
    {
      "info": {
        "name": "Vessel Data",
        "type": "folder"
      },
      "items": [
        {
          "info": { "name": "Ship specifications.", "type": "http" },
          "http": {
            "method": "GET",
            "url": "https://api.datalastic.com/api/v0/vessel_info",
            "params": [
              { "name": "imo", "value": "9525338", "type": "query", "description": "Vessel IMO number. Alternatively uuid or mmsi." }
            ]
          },
          "docs": "Static specs - MMSI, IMO, country, call sign, type/subtype, gross tonnage, deadweight, TEU, length, breadth, year built, home port. 1 credit per vessel."
        },
        {
          "info": { "name": "Vessel finder search.", "type": "http" },
          "http": {
            "method": "GET",
            "url": "https://api.datalastic.com/api/v0/vessel_find",
            "params": [
              { "name": "name", "value": "", "type": "query", "description": "Vessel name to search for." },
              { "name": "fuzzy", "value": "", "type": "query", "description": "1 for similar-name matching, 0 for exact." },
              { "name": "type", "value": "Cargo", "type": "query", "description": "Vessel type filter." },
              { "name": "type_specific", "value": "", "type": "query", "description": "Vessel subtype filter." },
              { "name": "country_iso", "value": "SG", "type": "query", "description": "Flag country, 2-letter ISO code." },
              { "name": "gross_tonnage_min", "value": "20000", "type": "query", "description": "Minimum gross tonnage." },
              { "name": "gross_tonnage_max", "value": "", "type": "query", "description": "Maximum gross tonnage." },
              { "name": "deadweight_min", "value": "", "type": "query", "description": "Minimum deadweight tonnage." },
              { "name": "deadweight_max", "value": "", "type": "query", "description": "Maximum deadweight tonnage." },
              { "name": "length_min", "value": "", "type": "query", "description": "Minimum length in meters." },
              { "name": "length_max", "value": "", "type": "query", "description": "Maximum length in meters." },
              { "name": "breadth_min", "value": "", "type": "query", "description": "Minimum breadth in meters." },
              { "name": "breadth_max", "value": "", "type": "query", "description": "Maximum breadth in meters." },
              { "name": "year_built_min", "value": "", "type": "query", "description": "Earliest year built." },
              { "name": "year_built_max", "value": "", "type": "query", "description": "Latest year built." },
              { "name": "next", "value": "", "type": "query", "description": "Pagination cursor." }
            ]
          },
          "docs": "Search the 750,000+ ship database by name (exact or fuzzy), type, subtype, country, tonnage, dimensions, and year built. 1 credit per vessel found."
        }
      ]
    },
    {
      "info": {
        "name": "Ports",
        "type": "folder"
      },
      "items": [
        {
          "info": { "name": "Port finder search.", "type": "http" },
          "http": {
            "method": "GET",
            "url": "https://api.datalastic.com/api/v0/port_find",
            "params": [
              { "name": "name", "value": "rotterdam", "type": "query", "description": "Port name to search for." },
              { "name": "fuzzy", "value": "", "type": "query", "description": "1 for similar-name matching, 0 for exact." }
            ]
          },
          "docs": "Search global maritime ports by name - returns name, country, UN/LOCODE, port type, coordinates, and area levels. 1 credit per port found."
        }
      ]
    },
    {
      "info": {
        "name": "Reports and Usage",
        "type": "folder"
      },
      "items": [
        {
          "info": { "name": "Submit an asynchronous report job.", "type": "http" },
          "http": {
            "method": "POST",
            "url": "https://api.datalastic.com/api/v0/report",
            "body": { "type": "json", "data": "{}" }
          },
          "docs": "Submits a bulk report job as JSON; the response includes a report_id to poll. Submission costs 1 credit."
        },
        {
          "info": { "name": "Check report status.", "type": "http" },
          "http": {
            "method": "GET",
            "url": "https://api.datalastic.com/api/v0/report",
            "params": [
              { "name": "report_id", "value": "", "type": "query", "description": "Report identifier, or _all to list all reports." }
            ]
          },
          "docs": "Polls report status (PENDING, IN_PROGRESS, DONE); returns a result_url download link when DONE. Free."
        },
        {
          "info": { "name": "API usage statistics.", "type": "http" },
          "http": {
            "method": "GET",
            "url": "https://api.datalastic.com/api/v0/stat"
          },
          "docs": "Current monthly credit consumption and request statistics for the api-key. Free - does not deduct credits."
        }
      ]
    }
  ]
}
