Datalastic

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.