openapi: 3.0.2
info:
title: MarineTraffic Vessel Positions API
version: 1.0.0
description: Retrieve current and historical AIS vessel positions for single vessels, fleets, areas of interest, ports,
and bounding boxes. Includes the modern AIS API and the Legacy Vessel Positions API plus the Vessel Historical Track endpoints.
contact:
name: MarineTraffic
url: https://www.marinetraffic.com/
servers:
- url: https://services.marinetraffic.com/api
tags:
- name: AIS API
- name: Vessel Positions (Legacy API)
- name: Vessel Historical Track
paths:
/exportvesseltrack/{api_key}:
get:
tags:
- Vessel Historical Track
summary: Single Vessel Historical Positions
description: "Get all historical positions of a single vessel for a specific period of time. Notes\
\ \n - Default resolution for returned positions is up to 2 minutes. Use \"period\" parameter to limit the\
\ frequency of positions
\n - Weather data is returned once within each hour's results
\n - Information\
\ about AIS-transmitted data
\n - **SPEED** speed over ground returned in (knots x10)
\n - **TIMESTAMP**\
\ UTC second when the report was generated (0-59)
\n - Historical positions are available since January 2015
\n\
\ - **Hourly** and **daily** records are the first records received during the hour or the day respectively
\n\
\ - When the **period** is **hourly**, the data field **HEADING** is not available for positions older than 2017-11-17
\n\
\ - **Hourly** records are available for dates after 2014-08-28
\n - Weather data for **winds** are\
\ available for dates after 2015-05-27
\n - Weather data for **waves**, **swells** and **currents** are available\
\ for dates after 2021-01-21
\n - The frequency of allowed API calls is specific to your API key and\
\ is detailed in your contract as a number of successful calls per time period. For example “2 calls per minute”.\
\ Regardless of this agreed limit, each API key is technically restricted to a maximum of 100 total (including\
\ successful and unsuccessful) requests per minute to ensure system stability.
\n
"
operationId: exportvesseltrack
parameters:
- $ref: '#/components/parameters/api_key'
- $ref: '#/components/parameters/v_PS01'
- $ref: '#/components/parameters/shipid_PS01'
- $ref: '#/components/parameters/mmsi_PS01'
- $ref: '#/components/parameters/imo_PS01'
- $ref: '#/components/parameters/days_PS01'
- $ref: '#/components/parameters/fromdate_PS01'
- $ref: '#/components/parameters/todate_PS01'
- $ref: '#/components/parameters/period_PS01'
- $ref: '#/components/parameters/msgtype_PS01'
- $ref: '#/components/parameters/protocol'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/200_ps01_default'
- $ref: '#/components/schemas/200_ps01_extended'
application/xml:
schema:
oneOf:
- $ref: '#/components/schemas/200_ps01_default'
- $ref: '#/components/schemas/200_ps01_extended'
examples:
Default:
summary: Simple
value: "\n\n \n \n \n \n \n"
Extended:
summary: Extended
value: "\n\n \n\
\ \n \n \n \n \n \n \n \n \n"
'400':
description: Bad Request
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/400_ps01_days_out_of_limit'
- $ref: '#/components/schemas/400_ps01_missing_ship_identifier'
application/xml:
schema:
oneOf:
- $ref: '#/components/schemas/400_ps01_days_out_of_limit'
- $ref: '#/components/schemas/400_ps01_missing_ship_identifier'
examples:
Days out of limit:
summary: Days out of limit
value: "\n\n \n \n \n"
Missing ship identifier:
summary: Missing ship identifier
value: "\n\n \n \
\ \n \n"
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/429_too_many_requests'
application/xml:
schema:
$ref: '#/components/schemas/429_too_many_requests'
examples:
Area out of bound:
summary: Too Many Requests
value: "\n\n \n \
\ \n \n"
'/exportvesseltrack/{api_key} ':
get:
tags:
- Vessel Historical Track
summary: Vessel Historical Positions in an Area
description: "Get vessel historical positions for a single or for all vessels inside an area of your preference for\
\ a specific period of time.\n \nNotes \n - Default resolution for returned positions\
\ is up to 2 minutes. Use \"period\" parameter to limit the frequency of positions
\n - Weather data is returned\
\ once within each hour's results
\n - Information about AIS-transmitted data
\n - **SPEED** speed over ground returned in (knots x10)
\n - **TIMESTAMP**\
\ UTC second when the report was generated (0-59)
\n - Historical positions are available since January 2015
\n\
\ - **Hourly** and **daily** records are the first records received during the hour or the day respectively
\n\
\ - When the **period** is **hourly**, the data field **HEADING** is not available for positions older than 2017-11-17
\n\
\ - **Hourly** records are available for dates after 2014-08-28
\n - Weather data for **winds** are\
\ available for dates after 2015-05-27
\n - Weather data for **waves**, **swells** and **currents** are available\
\ for dates after 2021-01-21
\n - The frequency of allowed API calls is specific to your API key and\
\ is detailed in your contract as a number of successful calls per time period. For example “2 calls per minute”.\
\ Regardless of this agreed limit, each API key is technically restricted to a maximum of 100 total (including\
\ successful and unsuccessful) requests per minute to ensure system stability.
\n
"
operationId: exportvesseltrack_
parameters:
- $ref: '#/components/parameters/api_key'
- $ref: '#/components/parameters/v_PS01'
- $ref: '#/components/parameters/days_PS01'
- $ref: '#/components/parameters/fromdate_PS01'
- $ref: '#/components/parameters/todate_PS01'
- $ref: '#/components/parameters/MINLAT_PS01'
- $ref: '#/components/parameters/MAXLAT_PS01'
- $ref: '#/components/parameters/MINLON_PS01'
- $ref: '#/components/parameters/MAXLON_PS01'
- $ref: '#/components/parameters/shipid_PS01_2'
- $ref: '#/components/parameters/mmsi_PS01'
- $ref: '#/components/parameters/imo_PS01'
- $ref: '#/components/parameters/period_PS01'
- $ref: '#/components/parameters/msgtype_PS01'
- $ref: '#/components/parameters/protocol'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/200_ps01_default'
- $ref: '#/components/schemas/200_ps01_extended'
application/xml:
schema:
oneOf:
- $ref: '#/components/schemas/200_ps01_default'
- $ref: '#/components/schemas/200_ps01_extended'
examples:
Default:
summary: Simple
value: "\n\n \n \n \n \n \n"
Extended:
summary: Extended
value: "\n\n \n \n \n\
\ \n \n \n \n \n \n \n"
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/400_ps01_area_out_of_bound'
application/xml:
schema:
$ref: '#/components/schemas/400_ps01_area_out_of_bound'
examples:
Area out of bound:
summary: Area out of bound
value: "\n\n \n \
\ \n \n"
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/429_too_many_requests'
application/xml:
schema:
$ref: '#/components/schemas/429_too_many_requests'
examples:
Area out of bound:
summary: Too Many Requests
value: "\n\n \n \
\ \n \n"
/exportvessels/{api_key}:
get:
tags:
- Vessel Positions (Legacy API)
summary: Vessel Positions of a Static Fleet
description: "Keep a close eye on the vessel or group of vessels of your interest. Notes \n \
\ - Information about AIS-transmitted data
\n - **SPEED** returned in (knots x10) and **TIMESTAMP** in UTC
\n - **HEADING**\
\ for SAR Aircrafts contains the Altitude of the aircraft (“STATUS” = 97)
\n - **HEADING** values -1 or 511\
\ indicate lack of data
\n - **SPEED** and **COURSE** values for base stations are represented by zero (0)
\n\
\ - More information about response parameters: STATUS, SHIPTYPE
\n - The frequency of allowed API calls is specific to your API key and is detailed\
\ in your contract as a number of successful calls per time period. For example “2 calls per minute”. Regardless\
\ of this agreed limit, each API key is technically restricted to a maximum of 100 total (including successful and\
\ unsuccessful) requests per minute to ensure system stability.
\n
"
operationId: exportvessels
parameters:
- $ref: '#/components/parameters/api_key'
- $ref: '#/components/parameters/v_PS02'
- $ref: '#/components/parameters/timespan_PS02'
- $ref: '#/components/parameters/shiptype_PS02'
- $ref: '#/components/parameters/msgtype_PS02'
- $ref: '#/components/parameters/protocol'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/200_ps02_default'
- $ref: '#/components/schemas/200_ps02_extended'
- $ref: '#/components/schemas/200_ps02_full'
application/xml:
schema:
oneOf:
- $ref: '#/components/schemas/200_ps02_default'
- $ref: '#/components/schemas/200_ps02_extended'
- $ref: '#/components/schemas/200_ps02_full'
examples:
Default:
summary: Simple
value: "\n\n \n \
\ |
\n
"
Extended:
summary: Extended
value: "\n\n \n \n
"
Full:
summary: Full
value: "\n\n |
\n \n
"
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/403_ps02_infinite_timespan'
application/xml:
schema:
$ref: '#/components/schemas/403_ps02_infinite_timespan'
examples:
Infinite timespan:
summary: Infinite timespan
value: "\n\n \n \
\ \n \n"
'/exportvessels/{api_key} ':
get:
tags:
- Vessel Positions (Legacy API)
summary: Vessel Positions of a Dynamic Fleet
description: "Monitor vessel activity for your MarineTraffic fleet(s). Notes \n - Information\
\ about AIS-transmitted data
\n - **SPEED** returned in (knots x10) and **TIMESTAMP** in UTC
\n - **HEADING**\
\ for SAR Aircrafts contains the Altitude of the aircraft (“STATUS” = 97)
\n - **HEADING** values -1 or 511\
\ indicate lack of data
\n - **SPEED** and **COURSE** values for base stations are represented by zero (0)
\n\
\ - More information about response parameters: STATUS, SHIPTYPE
\n - The frequency of allowed API calls is specific to your API key and is detailed\
\ in your contract as a number of successful calls per time period. For example “2 calls per minute”. Regardless\
\ of this agreed limit, each API key is technically restricted to a maximum of 100 total (including successful and\
\ unsuccessful) requests per minute to ensure system stability.
\n
"
operationId: exportvessels__
parameters:
- $ref: '#/components/parameters/api_key'
- $ref: '#/components/parameters/v_PS03'
- $ref: '#/components/parameters/timespan_PS03'
- $ref: '#/components/parameters/shiptype_PS03'
- $ref: '#/components/parameters/msgtype_PS03'
- $ref: '#/components/parameters/protocol'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/200_ps03_default'
- $ref: '#/components/schemas/200_ps03_extended'
- $ref: '#/components/schemas/200_ps03_full'
application/xml:
schema:
oneOf:
- $ref: '#/components/schemas/200_ps03_default'
- $ref: '#/components/schemas/200_ps03_extended'
- $ref: '#/components/schemas/200_ps03_full'
examples:
Default:
summary: Simple
value: "\n\n \n \
\ |
\n \n
"
Extended:
summary: Extended
value: "\n\n \n \n
"
Full:
summary: Full
value: "\n\n |
\n \n
"
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/429_too_many_requests'
application/xml:
schema:
$ref: '#/components/schemas/429_too_many_requests'
examples:
Area out of bound:
summary: Too Many Requests
value: "\n\n \n \
\ \n \n"
'/exportvessels/{api_key} ':
get:
tags:
- Vessel Positions (Legacy API)
summary: Vessel Positions Within a Port
description: "Monitor vessel activity in one or more ports of your interest. Notes \n - Information\
\ about AIS-transmitted data
\n - **SPEED** returned in (knots x10) and **TIMESTAMP** in UTC
\n - **HEADING**\
\ for SAR Aircrafts contains the Altitude of the aircraft (“STATUS” = 97)
\n - **HEADING** values -1 or 511\
\ indicate lack of data
\n - **SPEED** and **COURSE** values for base stations are represented by zero (0)
\n\
\ - More information about response parameters: STATUS, SHIPTYPE
\n - The frequency of allowed API calls is specific to your API key and is detailed\
\ in your contract as a number of successful calls per time period. For example “2 calls per minute”. Regardless\
\ of this agreed limit, each API key is technically restricted to a maximum of 100 total (including successful and\
\ unsuccessful) requests per minute to ensure system stability.
\n
"
operationId: exportvessels___
parameters:
- $ref: '#/components/parameters/api_key'
- $ref: '#/components/parameters/v_PS04'
- $ref: '#/components/parameters/timespan_PS04'
- $ref: '#/components/parameters/shiptype_PS04'
- $ref: '#/components/parameters/msgtype_PS04'
- $ref: '#/components/parameters/protocol'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/200_ps04_default'
- $ref: '#/components/schemas/200_ps04_extended'
- $ref: '#/components/schemas/200_ps04_full'
application/xml:
schema:
oneOf:
- $ref: '#/components/schemas/200_ps04_default'
- $ref: '#/components/schemas/200_ps04_extended'
- $ref: '#/components/schemas/200_ps04_full'
examples:
Default:
summary: Simple
value: "\n\n \n \n \
\ |
\n |
\n |
\n
"
Extended:
summary: Extended
value: "\n\n \n \n |
\n |
\n \n
"
Full:
summary: Full
value: "\n\n \n |
\n \n \n |
\n
"
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/429_too_many_requests'
application/xml:
schema:
$ref: '#/components/schemas/429_too_many_requests'
examples:
Area out of bound:
summary: Too Many Requests
value: "\n\n \n \
\ \n \n"
'/exportvessels/{api_key} ':
get:
tags:
- Vessel Positions (Legacy API)
summary: Vessel Positions in a Predefined Bounding Box
description: "Monitor vessel activity in an area of your interest. Notes \n - Information\
\ about AIS-transmitted data
\n - **SPEED** returned in (knots x10) and **TIMESTAMP** in UTC
\n - **HEADING**\
\ for SAR Aircrafts contains the Altitude of the aircraft (“STATUS” = 97)
\n - **HEADING** values -1 or 511\
\ indicate lack of data
\n - **SPEED** and **COURSE** values for base stations are represented by zero (0)
\n\
\ - More information about response parameters: STATUS, SHIPTYPE
\n - The frequency of allowed API calls is specific to your API key and is detailed\
\ in your contract as a number of successful calls per time period. For example “2 calls per minute”. Regardless\
\ of this agreed limit, each API key is technically restricted to a maximum of 100 total (including successful and\
\ unsuccessful) requests per minute to ensure system stability.
\n
"
operationId: exportvessels____
parameters:
- $ref: '#/components/parameters/api_key'
- $ref: '#/components/parameters/v_PS05'
- $ref: '#/components/parameters/timespan_PS05'
- $ref: '#/components/parameters/shiptype_PS05'
- $ref: '#/components/parameters/msgtype_PS05'
- $ref: '#/components/parameters/protocol'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/200_ps05_default'
- $ref: '#/components/schemas/200_ps05_extended'
- $ref: '#/components/schemas/200_ps05_full'
application/xml:
schema:
oneOf:
- $ref: '#/components/schemas/200_ps05_default'
- $ref: '#/components/schemas/200_ps05_extended'
- $ref: '#/components/schemas/200_ps05_full'
examples:
Default:
summary: Simple
value: "\n\n \n \n \
\ |
\n \n \n
"
Extended:
summary: Extended
value: "\n\n \n |
\n \n \n \n
"
Full:
summary: Full
value: "\n\n \n |
\n \n |
\n \n
"
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/429_too_many_requests'
application/xml:
schema:
$ref: '#/components/schemas/429_too_many_requests'
examples:
Area out of bound:
summary: Too Many Requests
value: "\n\n \n \
\ \n \n"
'/exportvessels/{api_key} ':
get:
tags:
- Vessel Positions (Legacy API)
summary: Vessel Positions in a Dynamic Bounding Box
description: "Retrieve positions for vessels sailing in an area that you define each time you call the service. \
\ Notes \n - Information about AIS-transmitted data
\n - **SPEED** returned in (knots x10) and **TIMESTAMP** in UTC
\n - **HEADING**\
\ for SAR Aircrafts contains the Altitude of the aircraft (“STATUS” = 97)
\n - **HEADING** values -1 or 511\
\ indicate lack of data
\n - **SPEED** and **COURSE** values for base stations are represented by zero (0)
\n\
\ - More information about response parameters: STATUS, SHIPTYPE
\n - The frequency of allowed API calls is specific to your API key and is detailed\
\ in your contract as a number of successful calls per time period. For example “2 calls per minute”. Regardless\
\ of this agreed limit, each API key is technically restricted to a maximum of 100 total (including successful and\
\ unsuccessful) requests per minute to ensure system stability.
\n
"
operationId: exportvessels_____
parameters:
- $ref: '#/components/parameters/api_key'
- $ref: '#/components/parameters/v_PS06'
- $ref: '#/components/parameters/timespan_PS06'
- $ref: '#/components/parameters/shiptype_PS06'
- $ref: '#/components/parameters/MAXLAT_PS06'
- $ref: '#/components/parameters/MINLON_PS06'
- $ref: '#/components/parameters/MAXLON_PS06'
- $ref: '#/components/parameters/MINLAT_PS06'
- $ref: '#/components/parameters/protocol'
- $ref: '#/components/parameters/msgtype_PS06'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/200_ps06_default'
- $ref: '#/components/schemas/200_ps06_extended'
- $ref: '#/components/schemas/200_ps06_full'
application/xml:
schema:
oneOf:
- $ref: '#/components/schemas/200_ps06_default'
- $ref: '#/components/schemas/200_ps06_extended'
- $ref: '#/components/schemas/200_ps06_full'
examples:
Default:
summary: Simple
value: "\n\n \n \n\
\ |
\n \n \n
"
Extended:
summary: Extended
value: "\n\n \n \n \n |
\n |
\n
"
Full:
summary: Full
value: "\n\n |
\n \n \n |
\n \n
"
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/429_too_many_requests'
application/xml:
schema:
$ref: '#/components/schemas/429_too_many_requests'
examples:
Area out of bound:
summary: Too Many Requests
value: "\n\n \n \
\ \n \n"
/exportvessel/{api_key}:
get:
tags:
- Vessel Positions (Legacy API)
summary: Single Vessel Positions
description: "Get the latest available position and voyage information for a particular vessel. Notes\
\ \n - Information about AIS-transmitted data
\n - **SPEED** returned in (knots x10) and TIMESTAMP in UTC
\n - **HEADING**\
\ for SAR Aircrafts contains the Altitude of the aircraft (“STATUS” = 97)
\n - **HEADING** values -1 or 511\
\ indicate lack of data
\n - **SPEED** and **COURSE** values for base stations are represented by zero (0)
\n\
\ - More information about response parameters: STATUS, SHIPTYPE
\n - The frequency of allowed API calls is specific to your API key and is detailed\
\ in your contract as a number of successful calls per time period. For example “2 calls per minute”. Regardless\
\ of this agreed limit, each API key is technically restricted to a maximum of 100 total (including successful and\
\ unsuccessful) requests per minute to ensure system stability.
\n
"
operationId: exportvessel
parameters:
- $ref: '#/components/parameters/api_key'
- $ref: '#/components/parameters/v_PS07'
- $ref: '#/components/parameters/shipid_PS07'
- $ref: '#/components/parameters/imo_PS07'
- $ref: '#/components/parameters/mmsi_PS07'
- $ref: '#/components/parameters/timespan_PS07'
- $ref: '#/components/parameters/msgtype_PS07'
- $ref: '#/components/parameters/protocol'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/200_ps07_default'
- $ref: '#/components/schemas/200_ps07_extended'
application/xml:
schema:
oneOf:
- $ref: '#/components/schemas/200_ps07_default'
- $ref: '#/components/schemas/200_ps07_extended'
examples:
Default:
summary: Simple
value: "\n\n \n
"
Extended:
summary: Extended
value: "\n\n \n\
"
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/400_ps07__missing_ship_identifier'
application/xml:
schema:
$ref: '#/components/schemas/400_ps07__missing_ship_identifier'
examples:
' Missing ship identifier':
summary: ' Missing ship identifier'
value: "\n\n \n \
\ \n \n"
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/429_too_many_requests'
application/xml:
schema:
$ref: '#/components/schemas/429_too_many_requests'
examples:
Area out of bound:
summary: Too Many Requests
value: "\n\n \n \
\ \n \n"
/exportvessels-custom-area/{api_key}:
get:
tags:
- Vessel Positions (Legacy API)
summary: Vessel Positions in a Custom Area
description: "Monitor vessel activity in a Custom Area of your interest. Notes \n - Information\
\ about AIS-transmitted data
\n - **SPEED** returned in (knots x10) and **TIMESTAMP** in UTC
\n - **HEADING**\
\ for SAR Aircrafts contains the Altitude of the aircraft (“STATUS” = 97)
\n - **HEADING** values -1 or 511\
\ indicate lack of data
\n - **SPEED** and **COURSE** values for base stations are represented by zero (0)
\n\
\ - More information about response parameters: STATUS, SHIPTYPE
\n - The frequency of allowed API calls is specific to your API key and is detailed\
\ in your contract as a number of successful calls per time period. For example “2 calls per minute”. Regardless\
\ of this agreed limit, each API key is technically restricted to a maximum of 100 total (including successful and\
\ unsuccessful) requests per minute to ensure system stability.
\n
"
operationId: exportvessels-custom-area
parameters:
- $ref: '#/components/parameters/api_key'
- $ref: '#/components/parameters/v_PS08'
- $ref: '#/components/parameters/timespan_PS08'
- $ref: '#/components/parameters/shiptype_generic_PS08'
- $ref: '#/components/parameters/shiptype_detailed_PS08'
- $ref: '#/components/parameters/msgtype_PS08'
- $ref: '#/components/parameters/protocol'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/200_ps08_default'
- $ref: '#/components/schemas/200_ps08_extended'
- $ref: '#/components/schemas/200_ps08_full'
application/xml:
schema:
oneOf:
- $ref: '#/components/schemas/200_ps08_default'
- $ref: '#/components/schemas/200_ps08_extended'
- $ref: '#/components/schemas/200_ps08_full'
examples:
Default:
summary: Simple
value: "\n\n \n \n \
\ |
\n \n \n
"
Extended:
summary: Extended
value: "\n\n \n |
\n \n \n \n
"
Full:
summary: Full
value: "\n\n \n |
\n \n |
\n \n
"
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/429_too_many_requests'
application/xml:
schema:
$ref: '#/components/schemas/429_too_many_requests'
examples:
Area out of bound:
summary: Too Many Requests
value: "\n\n \n \
\ \n \n"
'/exportvessels/{api_key} ':
get:
tags:
- AIS API
summary: Vessel Positions
description: "The latest version of this API endpoint, including significant improvements, is available here.Please contact your Customer Success Manager to request access to the new endpoint.\n\
Track vessels of interest anywhere in the world.Notes\n - Information about AIS-transmitted data
\n - **SPEED** speed over ground returned in (knots x10)
\n - **SPEED**\
\ and **COURSE** values for base stations are represented by zero (0)
\n - **TIMESTAMP** UTC second when\
\ the report was generated (0-59)
\n - **HEADING** true heading in degrees (0-359) (values -1 or 511 indicate\
\ lack of data)
\n - **HEADING** for SAR Aircrafts contains the Altitude of the aircraft (“STATUS” = 97)
\n\
\ - **DSRC** describes whether the transmitted AIS message was received by a terrestrial (TER), satellite (SAT)\
\ or roaming (ROAM) AIS antenna.
\n - The timespan parameter lets you specify how far back in time\
\ the API should look for the latest available vessel positions. Default value is set to 5 minutes and can be adjusted\
\ to a maximum of 1,440 minutes (24 hours).
\n - More information about response parameters: STATUS, SHIPTYPE
\n - The frequency of allowed API calls is specific to your API key and is detailed\
\ in your contract as a number of successful calls per time period. For example “2 calls per minute”. Regardless\
\ of this agreed limit, each API key is technically restricted to a maximum of 100 total (including successful and\
\ unsuccessful) requests per minute to ensure system stability.
\n
"
operationId: exportvessels______
parameters:
- $ref: '#/components/parameters/api_key'
- $ref: '#/components/parameters/v_MTA030AD_1'
- $ref: '#/components/parameters/timespan_MTA030AD'
- $ref: '#/components/parameters/vessel_type'
- $ref: '#/components/parameters/cursor'
- $ref: '#/components/parameters/limit'
- $ref: '#/components/parameters/protocol_mandatory'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/200_MTA030AD'
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/429_too_many_requests'
'/exportvessels-custom-area/{api_key} ':
get:
tags:
- AIS API
summary: Vessel Positions in an Area of Interest
description: "The latest version of this API endpoint, including significant improvements, is available here.Please contact your Customer Success Manager to request access to the new endpoint.\n\
Track Vessels of interest in a predefined area of interest.Notes\n - Information about AIS-transmitted\
\ data
\n - **SPEED** speed over ground returned in (knots x10)
\n - **SPEED** and **COURSE**\
\ values for base stations are represented by zero (0)
\n - **TIMESTAMP** UTC second when the report was\
\ generated (0-59)
\n - **HEADING** true heading in degrees (0-359) (values -1 or 511 indicate lack of data)
\n\
\ - **HEADING** for SAR Aircrafts contains the Altitude of the aircraft (“STATUS” = 97)
\n - **DSRC**\
\ describes whether the transmitted AIS message was received by a terrestrial (TER), satellite (SAT) or roaming (ROAM)\
\ AIS antenna.
\n - The timespan parameter lets you specify how far back in time the API should look\
\ for the latest available vessel positions. Default value is set to 5 minutes and can be adjusted to a maximum of\
\ 1,440 minutes (24 hours).
\n - More information about response parameters: STATUS, SHIPTYPE
\n - The frequency of allowed API calls is specific to your API key and is detailed\
\ in your contract as a number of successful calls per time period. For example “2 calls per minute”. Regardless\
\ of this agreed limit, each API key is technically restricted to a maximum of 100 total (including successful and\
\ unsuccessful) requests per minute to ensure system stability.
\n
"
operationId: exportvessels-custom-area_
parameters:
- $ref: '#/components/parameters/api_key'
- $ref: '#/components/parameters/v_MTA030AD_2'
- $ref: '#/components/parameters/timespan_MTA030AD'
- $ref: '#/components/parameters/vessel_type'
- $ref: '#/components/parameters/cursor'
- $ref: '#/components/parameters/limit'
- $ref: '#/components/parameters/protocol_mandatory'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/200_MTA030AD'
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/429_too_many_requests'
'/exportvessel/{api_key} ':
get:
tags:
- AIS API
summary: Single Vessel Positions
description: "The latest version of this API endpoint, including significant improvements, is available here.Please contact your Customer Success Manager to request access to the new endpoint.\n\
Get the latest available position and voyage information for a single vessel.Notes\n - Information\
\ about AIS-transmitted data
\n - **SPEED** speed over ground returned in (knots x10)
\n - **SPEED**\
\ and **COURSE** values for base stations are represented by zero (0)
\n - **TIMESTAMP** UTC second when\
\ the report was generated (0-59)
\n - **HEADING** true heading in degrees (0-359) (values -1 or 511 indicate\
\ lack of data)
\n - **HEADING** for SAR Aircrafts contains the Altitude of the aircraft (“STATUS” = 97)
\n\
\ - **DSRC** describes whether the transmitted AIS message was received by a terrestrial (TER), satellite (SAT)\
\ or roaming (ROAM) AIS antenna.
\n - The timespan parameter lets you specify how far back in time\
\ the API should look for the latest available vessel positions. Default value is set to 5 minutes and can be adjusted\
\ to a maximum of 1,440 minutes (24 hours).
\n - More information about response parameters: STATUS, SHIPTYPE
\n - The frequency of allowed API calls is specific to your API key and is detailed\
\ in your contract as a number of successful calls per time period. For example “2 calls per minute”. Regardless\
\ of this agreed limit, each API key is technically restricted to a maximum of 100 total (including successful and\
\ unsuccessful) requests per minute to ensure system stability.
\n
"
operationId: exportvessel_
parameters:
- $ref: '#/components/parameters/api_key'
- $ref: '#/components/parameters/v_MTA030AD_3'
- $ref: '#/components/parameters/shipid_PS07'
- $ref: '#/components/parameters/imo_PS07'
- $ref: '#/components/parameters/mmsi_PS07'
- $ref: '#/components/parameters/timespan_MTA030AD'
- $ref: '#/components/parameters/protocol_mandatory'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/200_MTA030AD_single'
'400':
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/400_ps07__missing_ship_identifier'
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/429_too_many_requests'
components:
parameters:
api_key:
name: api_key
in: path
description: 'API key: 40-character hexadecimal number'
required: true
schema:
type: string
cursor:
name: cursor
in: query
description: The pagination cursor provided in the metadata section of the previous response
required: false
schema:
type: string
limit:
name: limit
in: query
description: The limit of vessels per page (min=1000, max=5000)
required: false
schema:
type: integer
default: 2000
protocol_mandatory:
name: protocol
in: query
description: "Response type. Use one of the following: \n - jsono
\n - csv
"
required: false
schema:
type: string
default: jsono
protocol_new:
name: protocol
in: query
description: "Response type. Use one of the following: \n - xml
\n - csv
\n - jsono
"
required: false
schema:
type: string
default: xml
v_PS01:
name: v
in: query
description: Version of the service to be executed. Use version 3 to get the latest
schema:
type: integer
default: 1
shipid_PS01:
name: shipid
in: query
description: A uniquely assigned ID by MarineTraffic for the subject vessel You can instead use imo
or mmsi
required: true
schema:
type: integer
mmsi_PS01:
name: mmsi
in: query
description: The Maritime Mobile Service Identity (MMSI) of the vessel you wish to track
required: false
schema:
type: integer
imo_PS01:
name: imo
in: query
description: The International Maritime Organization (IMO) number of the vessel you wish to track
required: false
schema:
type: integer
days_PS01:
name: days
in: query
description: The number of days, starting from the time of request and going backwards, for which the response should
look for position data Maximum value is 190 (days)
required: true
schema:
type: integer
fromdate_PS01:
name: fromdate
in: query
description: Use with todate instead of days to get data for a date period
required: false
schema:
type: string
format: date-time
todate_PS01:
name: todate
in: query
description: Use with fromdate instead of days to get data for a date period
required: false
schema:
type: string
format: date-time
period_PS01:
name: period
in: query
description: "Limit position per vessel. Omit to get all the available positions Values are: \n - hourly:\
\ get one position per hour
\n - daily: get one position per day
\n
"
required: false
schema:
type: string
msgtype_PS01:
name: msgtype
in: query
description: "Resolution of the response. Available values: If used\
\ with the value extended, the response includes also weather data"
required: false
schema:
type: string
default: simple
protocol:
name: protocol
in: query
description: "Response type. Use one of the following: \n - xml
\n - csv
\n - json
\n - jsono
"
required: false
schema:
type: string
default: xml
MINLAT_PS01:
name: MINLAT
in: query
description: Use with MAXLAT, MINLON, MAXLON to define an area for which you wish to either get all the historical vessels'
positions or historical positions for a specific vessel The absolute value of MAXLAT - MINLAT + MAXLON
- MINLON has to be equal to or less than 2 If you do not define a vessel, the maximum period for
which you can look back has a maximum period of one day
required: true
schema:
type: number
MAXLAT_PS01:
name: MAXLAT
in: query
description: Use with MINLAT, MINLON, MAXLON to define an area for which you wish to either get all the historical vessels'
positions or historical positions for a specific vessel The absolute value of MAXLAT - MINLAT + MAXLON
- MINLON has to be equal to or less than 2 If you do not define a vessel, the maximum period for
which you can look back has a maximum period of one day
required: true
schema:
type: number
MINLON_PS01:
name: MINLON
in: query
description: Use with MINLAT, MAXLAT, MAXLON to define an area for which you wish to either get all the historical vessels'
positions or historical positions for a specific vessel The absolute value of MAXLAT - MINLAT + MAXLON
- MINLON has to be equal to or less than 2 If you do not define a vessel, the maximum period for
which you can look back has a maximum period of one day
required: true
schema:
type: number
MAXLON_PS01:
name: MAXLON
in: query
description: Use with MINLAT, MAXLAT, MINLON to define an area for which you wish to either get all the historical vessels'
positions or historical positions for a specific vessel The absolute value of MAXLAT - MINLAT + MAXLON
- MINLON has to be equal to or less than 2 If you do not define a vessel, the maximum period for
which you can look back has a maximum period of one day
required: true
schema:
type: number
shipid_PS01_2:
name: shipid
in: query
description: A uniquely assigned ID by MarineTraffic for the subject vessel You can instead use imo
or mmsi
required: false
schema:
type: integer
v_PS02:
name: v
in: query
description: Version of the service to be executed. Use version 8 to get the latest
required: true
schema:
type: integer
default: 1
timespan_PS02:
name: timespan
in: query
description: The maximum age, in minutes, of the returned positions. Maximum value for terrestrial coverage
is 60. Maximum value for satellite coverage is 180
required: false
schema:
type: integer
default: 5
shiptype_PS02:
name: shiptype
in: query
description: "Filter data by vessel type: \n - 2: Fishing
\n - 4: High Speed Craf
\n - 6: Passenger
\n\
\ - 7: Cargo
\n - 8: Tanker
"
required: false
schema:
type: integer
msgtype_PS02:
name: msgtype
in: query
description: "Resolution of the response. Available values: \n - simple
\n - extended
\n - full
\n\
If used with the value extended or full, the response includes scheduled static and voyage related\
\ vessel data report (AIS Message 5). In this case your request frequency might be limited (depending on your service\
\ terms) If omitted, the returned records include only position reports (AIS Messages 1, 2, 3/ 18, 19)"
required: false
schema:
type: string
default: simple
v_PS03:
name: v
in: query
description: Version of the service to be executed. Use version 8 to get the latest
required: true
schema:
type: integer
default: 1
vessel_type:
name: vesseltypeid
in: query
description: Filter vessels based on vessel types, comma separated ids supported more
required: false
schema:
type: integer
timespan_PS03:
name: timespan
in: query
description: The maximum age, in minutes, of the returned positions Maximum value for terrestrial coverage
is 60. Maximum value for satellite coverage is 180
required: false
schema:
type: integer
default: 5
shiptype_PS03:
name: shiptype
in: query
description: "Filter data by vessel type: \n - 2: Fishing
\n - 4: High Speed Craf
\n - 6: Passenger
\n\
\ - 7: Cargo
\n - 8: Tanker
"
required: false
schema:
type: integer
msgtype_PS03:
name: msgtype
in: query
description: "Resolution of the response. Available values: \n - simple
\n - extended
\n - full
\n\
If used with the value extended or full, the response includes scheduled static and voyage related\
\ vessel data report (AIS Message 5). In this case your request frequency might be limited (depending on your service\
\ terms) If omitted, the returned records include only position reports (AIS Messages 1, 2, 3/ 18, 19)"
required: false
schema:
type: string
default: simple
v_PS04:
name: v
in: query
description: Version of the service to be executed. Use version 8 to get the latest
required: true
schema:
type: integer
default: 1
timespan_PS04:
name: timespan
in: query
description: The maximum age, in minutes, of the returned positions Maximum value for terrestrial coverage
is 60. Maximum value for satellite coverage is 180
required: false
schema:
type: integer
default: 5
shiptype_PS04:
name: shiptype
in: query
description: "Filter data by vessel type: \n - 2: Fishing
\n - 4: High Speed Craf
\n - 6: Passenger
\n\
\ - 7: Cargo
\n - 8: Tanker
"
required: false
schema:
type: integer
msgtype_PS04:
name: msgtype
in: query
description: "Resolution of the response. Available values: \n - simple
\n - extended
\n - full
\n\
If used with the value extended or full, the response includes scheduled static and voyage related\
\ vessel data report (AIS Message 5). In this case your request frequency might be limited (depending on your service\
\ terms) If omitted, the returned records include only position reports (AIS Messages 1, 2, 3/ 18, 19)"
required: false
schema:
type: string
default: simple
v_PS05:
name: v
in: query
description: Version of the service to be executed. Use version 8 to get the latest
required: true
schema:
type: integer
default: 1
timespan_PS05:
name: timespan
in: query
description: The maximum age, in minutes, of the returned positions Maximum value for terrestrial coverage
is 60. Maximum value for satellite coverage is 180
required: false
schema:
type: integer
default: 5
shiptype_PS05:
name: shiptype
in: query
description: "Filter data by vessel type: \n - 2: Fishing
\n - 4: High Speed Craf
\n - 6: Passenger
\n\
\ - 7: Cargo
\n - 8: Tanker
"
required: false
schema:
type: integer
msgtype_PS05:
name: msgtype
in: query
description: "Resolution of the response. Available values: \n - simple
\n - extended
\n - full
\n\
If used with the value extended or full, the response includes scheduled static and voyage related\
\ vessel data report (AIS Message 5). In this case your request frequency might be limited (depending on your service\
\ terms) If omitted, the returned records include only position reports (AIS Messages 1, 2, 3/ 18, 19)"
required: false
schema:
type: string
default: simple
v_PS06:
name: v
in: query
description: Version of the service to be executed. Use version 8 to get the latest
required: true
schema:
type: integer
default: 1
v_MTA030AD_1:
name: v
in: query
description: Use latest version **9**
required: true
schema:
type: integer
v_MTA030AD_2:
name: v
in: query
description: Use latest version **2**
required: true
schema:
type: integer
v_MTA030AD_3:
name: v
in: query
description: Use latest version **6**
required: true
schema:
type: integer
timespan_PS06:
name: timespan
in: query
description: The maximum age, in minutes, of the returned positions. Maximum value is 2880
required: false
schema:
type: integer
default: 5
shiptype_PS06:
name: shiptype
in: query
description: "Filter data by vessel type: \n - 2: Fishing
\n - 4: High Speed Craf
\n - 6: Passenger
\n\
\ - 7: Cargo
\n - 8: Tanker
"
required: false
schema:
type: integer
MAXLAT_PS06:
name: MAXLAT
in: query
description: Use with MINLAT, MINLON, MAXLON to define an area and retrieve positional information of vessels sailing
in it
required: true
schema:
type: number
MINLON_PS06:
name: MINLON
in: query
description: Use with MINLAT, MAXLAT, MAXLON to define an area and retrieve positional information of vessels sailing
in it
required: true
schema:
type: number
MAXLON_PS06:
name: MAXLON
in: query
description: Use with MINLAT, MINLON, MAXLAT to define an area and retrieve positional information of vessels sailing
in it
required: true
schema:
type: number
MINLAT_PS06:
name: MINLAT
in: query
description: Use with MAXLAT, MINLON, MAXLON to define an area and retrieve positional information of vessels sailing
in it
required: true
schema:
type: number
msgtype_PS06:
name: msgtype
in: query
description: "Resolution of the response. Available values: \n - simple
\n - extended
\n - full
\n\
If used with the value extended or full, the response includes scheduled static and voyage related\
\ vessel data report (AIS Message 5). In this case your request frequency might be limited (depending on your service\
\ terms) If omitted, the returned records include only position reports (AIS Messages 1, 2, 3/ 18, 19)"
required: false
schema:
type: string
default: simple
v_PS07:
name: v
in: query
description: Version of the service to be executed. Use version 5 to get the latest
required: true
schema:
type: integer
default: 1
shipid_PS07:
name: shipid
in: query
description: A uniquely assigned ID by MarineTraffic for the subject vessel You can instead use imo
or mmsi
required: true
schema:
type: integer
imo_PS07:
name: imo
in: query
description: The International Maritime Organization (IMO) number of the vessel you wish to track
required: false
schema:
type: integer
mmsi_PS07:
name: mmsi
in: query
description: The Maritime Mobile Service Identity (MMSI) of the vessel you wish to track
required: false
schema:
type: integer
timespan_PS07:
name: timespan
in: query
description: The maximum age, in minutes, of the returned positions. Maximum value is 2880
required: false
schema:
type: integer
default: 2
msgtype_PS07:
name: msgtype
in: query
description: "Resolution of the response. Available values: If used\
\ with the value extended, the response includes scheduled static and voyage related vessel data report (AIS\
\ Message 5). In this case your request frequency might be limited (depending on your service terms) If\
\ omitted, the returned records include only position reports (AIS Messages 1, 2, 3/ 18, 19)"
required: false
schema:
type: string
default: simple
v_PS08:
name: v
in: query
description: Version of the service to be executed. Use version 1 to get the latest
required: true
schema:
type: integer
default: 1
timespan_PS08:
name: timespan
in: query
description: The maximum age, in minutes, of the returned positions. Maximum value is 2880
required: false
schema:
type: integer
default: 5
shiptype_generic_PS08:
name: shiptype_generic
in: query
description: Filter vessels based on generic vessel types, comma separated values supported Vessel type ID
should be used and not vessel type name (2=Fishing / 4=High Speed Craft / 6=Passenger / 7=Cargo / 8=Tanker)
Should not be combined with shiptype_detailed filter
required: false
schema:
type: integer
shiptype_detailed_PS08:
name: shiptype_detailed
in: query
description: Filter vessels based on detailed vessel types, comma separated values supported Vessel type
ID should be used and not vessel type name - more
Should not be combined with shiptype_generic filter
required: false
schema:
type: integer
msgtype_PS08:
name: msgtype
in: query
description: "Resolution of the response. Available values: \n - simple
\n - extended
\n - full
\n\
If used with the value extended or full, the response includes scheduled static and voyage related\
\ vessel data report (AIS Message 5). In this case your request frequency might be limited (depending on your service\
\ terms) If omitted, the returned records include only position reports (AIS Messages 1, 2, 3/ 18, 19)"
required: false
schema:
type: string
default: simple
timespan_MTA030AD:
name: timespan
in: query
description: Overrides the default timespan
required: false
schema:
type: integer
default: 5
v_EV01:
name: v
in: query
description: Version of the service to be executed. Use version 6 to get the latest
required: true
schema:
type: integer
default: 1
shipid_EV01:
name: shipid
in: query
description: A uniquely assigned ID by MarineTraffic for the subject vessel You can instead use imo
or mmsi
required: true
schema:
type: integer
mmsi_EV01:
name: mmsi
in: query
description: The Maritime Mobile Service Identity (MMSI) of the vessel you wish to track
required: false
schema:
type: integer
imo_EV01:
name: imo
in: query
description: The International Maritime Organization (IMO) number of the vessel you wish to track
required: false
schema:
type: integer
timespan_EV01:
name: timespan
in: query
description: The maximum age, in minutes, of the returned port calls. Maximum value is 2880
required: false
schema:
type: integer
default: 2
movetype_EV01:
name: movetype
in: query
description: Use 0 to only receive arrivals or 1 to only receive departures. If not used, the response will include
both
required: false
schema:
type: integer
exclude_intransit_EV01:
name: exclude_intransit
in: query
description: Use 1 to exclude vessels in transit
required: false
schema:
type: integer
fromdate_EV01:
name: fromdate
in: query
description: 'Portcalls between fromdate and todate. Maximum period requested 190 days Date format: YYYY-MM-DD
HH:MM'
required: false
schema:
type: string
format: date-time
todate_EV01:
name: todate
in: query
description: 'Portcalls between fromdate and todate. Maximum period requested 190 days Date format: YYYY-MM-DD
HH:MM'
required: false
schema:
type: string
format: date-time
dwt_min_EV01:
name: dwt_min
in: query
description: 'Data filter: minimum DWT Applicable to IMO-having vessels'
required: false
schema:
type: integer
dwt_max_EV01:
name: dwt_max
in: query
description: 'Data filter: maximum DWT Applicable to IMO-having vessels'
required: false
schema:
type: integer
gt_min_EV01:
name: gt_min
in: query
description: 'Data filter: minimum GT Applicable to IMO-having vessels'
required: false
schema:
type: integer
gt_max_EV01:
name: gt_max
in: query
description: 'Data filter: maximum GT Applicable to IMO-having vessels'
required: false
schema:
type: integer
market_EV01:
name: market
in: query
description: Define market(s) for which you would like to receive port calls (single or comma separated values) - more
required: false
schema:
type: string
msgtype_EV01:
name: msgtype
in: query
description: "Resolution of the response. Available values: If used\
\ with the value extended, the response includes voyage related data since the previous port call"
required: false
schema:
type: string
default: simple
v_EV02:
name: v
in: query
description: Version of the service to be executed. Use version 2 to get the latest
required: true
schema:
type: integer
default: 1
shipid_EV02:
name: shipid
in: query
description: A uniquely assigned ID by MarineTraffic for the subject vessel You can instead use imo
or mmsi
required: true
schema:
type: integer
mmsi_EV02:
name: mmsi
in: query
description: The Maritime Mobile Service Identity (MMSI) of the vessel you wish to track
required: false
schema:
type: integer
imo_EV02:
name: imo
in: query
description: The International Maritime Organization (IMO) number of the vessel you wish to track
required: false
schema:
type: integer
timespan_EV02:
name: timespan
in: query
description: The maximum age, in minutes, of the returned port calls. Maximum value is 2880
required: false
schema:
type: integer
default: 60
fromdate_EV02:
name: fromdate
in: query
description: 'Vessel Events between fromdate and todate Date format: YYYY-MM-DD HH:MM:SS'
required: false
schema:
type: string
format: date-time
todate_EV02:
name: todate
in: query
description: 'Vessel Events between fromdate and todate Date format: YYYY-MM-DD HH:MM:SS'
required: false
schema:
type: string
format: date-time
event_type_EV02:
name: event_type
in: query
description: You may use one or more event ids in comma separated format for the events you wish to receive
required: false
schema:
type: integer
limit_events_EV02:
name: limit_events
in: query
description: Limit the number of results
required: false
schema:
type: integer
v_EV03:
name: v
in: query
description: Version of the service to be executed. Use version 3 to get the latest
required: true
schema:
type: integer
default: 1
shipid_EV03:
name: shipid
in: query
description: A uniquely assigned ID by MarineTraffic for the subject vessel You can instead use imo
or mmsi
required: true
schema:
type: integer
mmsi_EV03:
name: mmsi
in: query
description: The Maritime Mobile Service Identity (MMSI) of the vessel you wish to track
required: false
schema:
type: integer
imo_EV03:
name: imo
in: query
description: The International Maritime Organization (IMO) number of the vessel you wish to track
required: false
schema:
type: integer
timespan_EV03:
name: timespan
in: query
description: The maximum age, in minutes, of the returned port calls. Maximum value is 2880
required: false
schema:
type: integer
default: 2
fromdate_EV03:
name: fromdate
in: query
description: 'Return Berth Calls where DOCK_TIMESTAMP_UTC is equal to or greater than provided fromdate. Maximum period
requested 15 days Date format: YYYY-MM-DD HH:MM:SS.'
required: false
schema:
type: string
format: date-time
todate_EV03:
name: todate
in: query
description: 'Return Berth Calls where DOCK_TIMESTAMP_UTC is equal to or less than provided todate. Maximum period requested
15 days Date format: YYYY-MM-DD HH:MM:SS'
required: false
schema:
type: string
format: date-time
market_EV03:
name: market
in: query
description: "Define market for which you would like to receive berth calls - more \n - if undefined and ship-class is also undefined, then return all
\n - if undefined and\
\ ship-class is defined, return based on ship-class
\n - if defined and ship-class is undefined, return all\
\ ship-classes of the specific market
\n
"
required: false
schema:
type: string
shipclass_EV03:
name: shipclass
in: query
description: Define ship class of interest - more
required: false
schema:
type: integer
dwt_min_EV03:
name: dwt_min
in: query
description: 'Data filter: minimum DWT Use it to filter by size Cargo and Tanker IMO-having vessels (shiptype
= 7,8)'
required: false
schema:
type: integer
dwt_max_EV03:
name: dwt_max
in: query
description: 'Data filter: maximum DWT Use it to filter by size Cargo and Tanker IMO-having vessels (shiptype
= 7,8)'
required: false
schema:
type: integer
gt_min_EV03:
name: gt_min
in: query
description: 'Data filter: minimum GT Applicable to IMO-having vessels'
required: false
schema:
type: integer
gt_max_EV03:
name: gt_max
in: query
description: 'Data filter: maximum GT Applicable to IMO-having vessels'
required: false
schema:
type: integer
movetype_EV03:
name: movetype
in: query
description: Use 0 to include both, 1 to only receive dockings or 2 for only undockings within the defined period. If
not used, only dockings are returned Available only from version 2 of the service
required: false
schema:
type: integer
msgtype_EV03:
name: msgtype
in: query
description: "Resolution of the response. Available values: If used\
\ with the value extended, the response includes voyage related data since the previous port call"
required: false
schema:
type: string
default: simple
portid_EV01:
name: portid
in: query
description: The MarineTraffic ID of the port you wish to monitor (found on the URL of the respective Port page) or
port UN/LOCODE
required: true
schema:
type: integer
portid_EV03:
name: portid
in: query
description: The MarineTraffic ID of the port you wish to monitor (found on the URL of the respective Port page)
You can instead use port_unlocode, berthid or terminalid
required: true
schema:
type: integer
port_unlocode_EV03:
name: port_unlocode
in: query
description: Port UN LOCODE (without gaps or spaces)
required: false
schema:
type: integer
berthid_EV03:
name: berthid
in: query
description: 'The MarineTraffic ID of the berth you wish to monitor (list to be provided upon request) '
required: false
schema:
type: integer
terminalid_EV03:
name: terminalid
in: query
description: The MarineTraffic ID of the terminal you wish to monitor (list to be provided upon request)
required: false
schema:
type: integer
vessel_id_VD01:
name: vessel_id
in: query
description: The Maritime Mobile Service Identity (MMSI) or the IMO number of the vessel You can instead
use shipid
required: true
schema:
type: integer
shipid_VD01:
name: shipid
in: query
description: A uniquely assigned ID by MarineTraffic for the subject vessel
required: false
schema:
type: integer
v_VD02:
name: v
in: query
description: Version of the service to be executed. Use version 5 to get the latest
required: true
schema:
type: integer
default: 1
msgtype_VD02:
name: msgtype
in: query
description: "Resolution of the response. Available values: "
required: false
schema:
type: string
default: simple
mmsi_VD02:
name: mmsi
in: query
description: The Maritime Mobile Service Identity (MMSI) of the vessel you wish to track (single or comma separated
values) You can instead use imo or shipid
required: true
schema:
type: integer
imo_VD02:
name: imo
in: query
description: The International Maritime Organization (IMO) number of the vessel you wish to track (single or comma separated
values)
required: false
schema:
type: integer
shipid_VD02:
name: shipid
in: query
description: A uniquely assigned ID by MarineTraffic for the subject vessel (single or comma separated values)
required: false
schema:
type: integer
timespan_VD02:
name: timespan
in: query
description: The timespan parameter defines the period of time, during which we want to receive the change in a vessel's
details The maximum value can be either 5 when the interval parameter is set to days or 2880 when the interval
is set to minutes
required: false
schema:
type: integer
interval_VD02:
name: interval
in: query
description: The interval parameter can be either minutes or days
required: false
schema:
type: string
default: minutes
page_VD02:
name: page
in: query
description: Page number of the results to be returned
required: false
schema:
type: integer
default: 1
shipid_VD03:
name: shipid
in: query
description: A uniquely assigned ID by MarineTraffic for the subject vessel You can instead use mmsi
or imo
required: true
schema:
type: integer
mmsi_VD03:
name: mmsi
in: query
description: The Maritime Mobile Service Identity (MMSI) of the vessel you wish to track NOTE: Using
MMSI may potentially return multiple records as multiple vessels might have transponded the same MMSI
required: false
schema:
type: integer
imo_VD03:
name: imo
in: query
description: The International Maritime Organization (IMO) number of the vessel you wish to track NOTE:
Using IMO may potentially return multiple records as multiple vessels might have transponded the same IMO
required: false
schema:
type: integer
shiptype_VD03:
name: shiptype
in: query
description: "Filter data by vessel type: \n - 2: Fishing
\n - 4: High Speed Craf
\n - 6: Passenger
\n\
\ - 7: Cargo
\n - 8: Tanker
"
required: false
schema:
type: integer
type_name_id_VD03:
name: type_name_id
in: query
description: 'Data filter: AIS Shiptype Find more information here'
required: false
schema:
type: integer
shipname_VD03:
name: shipname
in: query
description: The vessel name. The results will contain all vessels whose name is like the given words
required: true
schema:
type: string
v_VI01:
name: v
in: query
description: Version of the service to be executed. Use version 2 to get the latest
required: true
schema:
type: integer
default: 1
mmsi_VI01:
name: mmsi
in: query
description: The Maritime Mobile Service Identity (MMSI) of the vessel you wish to track You can instead
use imo or shipid
required: true
schema:
type: integer
imo_VI01:
name: imo
in: query
description: The International Maritime Organization (IMO) number of the vessel you wish to track
required: false
schema:
type: integer
shipid_VI01:
name: shipid
in: query
description: A uniquely assigned ID by MarineTraffic for the subject vessel
required: false
schema:
type: integer
msgtype_VI01:
name: msgtype
in: query
description: "Resolution of the response. Available values: If used\
\ with the value extended, the response includes voyage related information (eg. distance travelled and to-go,\
\ load condition) and the estimated route to the vessel's destination"
required: false
schema:
type: string
default: simple
fleet_id_VI01:
name: fleet_id
in: query
description: The fleet id you wish to receive voyage forecast for
required: true
schema:
type: integer
mmsi_VI04:
name: mmsi
in: query
description: The Maritime Mobile Service Identity (MMSI) of the vessel you wish to track You can instead
use imo or shipid
required: true
schema:
type: integer
imo_VI04:
name: imo
in: query
description: The International Maritime Organization (IMO) number of the vessel you wish to track
required: false
schema:
type: integer
shipid_VI04:
name: shipid
in: query
description: A uniquely assigned ID by MarineTraffic for the subject vessel
required: false
schema:
type: integer
fromportid_VI04:
name: fromportid
in: query
description: The MarineTraffic ID of the port you wish to receive a prediction (found on the URL of the respective Port
page)
required: false
schema:
type: integer
fleet_id_VI04:
name: fleet_id
in: query
description: The MarineTraffic ID of the fleet you wish to track
required: true
schema:
type: integer
v_VI07:
name: v
in: query
description: Version of the service to be executed. Use version 2 to get the latest
required: true
schema:
type: integer
default: 1
portid_VI07:
name: portid
in: query
description: The MarineTraffic ID of the port you wish to receive ETA info You can instead use unlocode
required: true
schema:
type: integer
unlocode_VI07:
name: unlocode
in: query
description: The UN LOCODE (without gaps or spaces) of the port you wish to receive ETA info
required: false
schema:
type: string
mmsi_VI07:
name: mmsi
in: query
description: The Maritime Mobile Service Identity (MMSI) of the vessel you wish to track You can instead
use imo or shipid
required: true
schema:
type: integer
imo_VI07:
name: imo
in: query
description: The International Maritime Organization (IMO) number of the vessel you wish to track
required: false
schema:
type: integer
shipid_VI07:
name: shipid
in: query
description: A uniquely assigned ID by MarineTraffic for the subject vessel
required: false
schema:
type: integer
speed_calc_VI07:
name: speed_calc
in: query
description: "The Speed of the Vessel that MarineTraffic will use to produce the ETA value \n - if not defined\
\ the last average speed of the Vessel will be used
\n - if no average speed exists then a default value of\
\ 12(kn) will be used
\n
"
required: false
schema:
type: integer
msgtype_VI07:
name: msgtype
in: query
description: "Resolution of the response. Available values: If used\
\ with the value extended, the response includes voyage related data"
required: false
schema:
type: string
default: simple
v_VI02:
name: v
in: query
description: Version of the service to be executed. Use version 4 to get the latest
required: true
schema:
type: integer
default: 1
portid_VI02:
name: portid
in: query
description: The MarineTraffic ID of the port (found on the URL of the respective Port page)
required: true
schema:
type: integer
timespan_VI02:
name: timespan
in: query
description: Number of days in the future to look for expected arrivals, starting from the time the API call is requested
Maximum value is 40 days If neither this nor the fromdate/todate parameters are used, the response
only includes vessels currently in port (or the country’s ports) and the last vessel's signal is received during the
last 2 days
required: false
schema:
type: integer
days_last_signal_VI02:
name: days_last_signal
in: query
description: Include vessels currently in port that have transmitted a position within the last x days (based on their
last signal timestamp). This parameter only works when no other timeframe is defined.
required: false
schema:
type: integer
fromdate_VI02:
name: fromdate
in: query
description: 'Timestamp in the future to start looking for expected arrivals. If used, then you should also define the
todate parameter Date format: YYYY-MM-DD HH:MM:SS'
required: false
schema:
type: string
format: date-time
todate_VI02:
name: todate
in: query
description: 'Timestamp in the future to start looking for expected arrivals. If used, then you should also define the
fromdate parameter Date format: YYYY-MM-DD HH:MM:SS'
required: false
schema:
type: string
format: date-time
fromportid_VI02:
name: fromportid
in: query
description: The MarineTraffic ID of the previous port (found on the URL of the respective Port page) or previous port
UNLOCODE
required: false
schema:
type: integer
shiptype_VI02:
name: shiptype
in: query
description: "Filter data by vessel type: \n - 2: Fishing
\n - 4: High Speed Craf
\n - 6: Passenger
\n\
\ - 7: Cargo
\n - 8: Tanker
"
required: false
schema:
type: integer
dwt_min_VI02:
name: dwt_min
in: query
description: 'Data filter: minimum DWT Use it to filter by size Cargo and Tanker IMO-having vessels (shiptype
= 7,8). If used, then you should also define the dwt_max parameter'
required: false
schema:
type: integer
dwt_max_VI02:
name: dwt_max
in: query
description: 'Data filter: maximum DWT Use it to filter by size Cargo and Tanker IMO-having vessels (shiptype
= 7,8). If used, then you should also define the dwt_min parameter'
required: false
schema:
type: integer
gt_min_VI02:
name: gt_min
in: query
description: 'Data filter: minimum GT Applicable to IMO-having vessels. If used, then you should also define
the gt_max parameter'
required: false
schema:
type: integer
gt_max_VI02:
name: gt_max
in: query
description: 'Data filter: maximum GT Applicable to IMO-having vessels. If used, then you should also define
the gt_min parameter'
required: false
schema:
type: integer
msgtype_VI02:
name: msgtype
in: query
description: "Resolution of the response. Available values: If used\
\ with the value extended, apart from the ETA information, the response includes main vessel particulars. If\
\ omitted, the returned records include only position and ETA reports"
required: false
schema:
type: string
default: simple
country_VI02:
name: country
in: query
description: The Country code of interest. Response includes all ports within the Country
required: true
schema:
type: integer
portid_VI05:
name: portid
in: query
description: The MarineTraffic ID of the port you wish to receive probable visits (found on the URL of the respective
Port page)
required: true
schema:
type: integer
market_VI05:
name: market
in: query
description: "Define market for which you would like to receive probable visits - more \n - if undefined and ship-class is also undefined, then return all
\n - if undefined and\
\ ship-class is defined, return based on ship-class
\n - If defined and ship-class is undefined, return all\
\ ship-classes of the specific market
\n
"
required: false
schema:
type: integer
shipclass_VI05:
name: shipclass
in: query
description: Define ship class of interest - more
required: false
schema:
type: integer
probability_VI05:
name: probability
in: query
description: Define probability over which you would like to receive probable visits (accepted > 0.3)
required: false
schema:
type: integer
portid_VI06:
name: portid
in: query
description: The MarineTraffic ID of the port for which you wish to retrieve congestion metrics (found on the URL of
the respective Port page). If you wish to retrieve congestion metrics for all ports, instead of portid
use agg_port=1
required: true
schema:
type: integer
year_VI06:
name: year
in: query
description: Year of interest (data available back to 1 year). Information further back can be requested ad-hoc
required: true
schema:
type: integer
week_VI06:
name: week
in: query
description: Week of Year that is of interest (e.g. for week 18/2018 input 18). For range of weeks use comma e.g. for
weeks 30 to 35 (30,35)
required: true
schema:
type: integer
market_VI06:
name: market
in: query
description: "Define market for which you would like to receive port congestion - more \n - if undefined and ship-class is also undefined, then figures for ALL markets/ship-class
\n\
\ - if undefined and ship-class is defined, returns based on ship-class for ALL applicable to size class markets
\n\
\ - if defined and ship-class is undefined, returns figures for the specific market (no size class breakdown)
\n\
If you wish to retrieve congestion metrics for all markets, instead of market use agg_market\
\ query parameter (=0 or =1)"
required: true
schema:
type: integer
shipclass_VI06:
name: shipclass
in: query
description: Define ship class of interest - more
If you wish to retrieve congestion metrics for all ship classes, instead of shipclass use agg_shipclass
query parameter (=0 or =1)
required: true
schema:
type: integer
agg_port_VI06:
name: agg_port
in: query
description: "**If used, portid should not be in request** \n - when agg_port = 1 is used, aggregation result\
\ of all ports are returned
\n - when agg_port = 1 is used, agg_market cannot be 1
\n
"
required: false
schema:
type: integer
agg_market_VI06:
name: agg_market
in: query
description: "**If used, market should not be in request** \n - if agg_market = 1, aggregation result of all\
\ markets will be returned
\n - if 0, a breakdown of markets will be returned
\n
"
required: false
schema:
type: integer
agg_shipclass_VI06:
name: agg_shipclass
in: query
description: "**If used, shipclass should not be in request** \n - if agg_shipclass = 1, aggregation result of\
\ all classes will be returned
\n - if 0, a breakdown of classes will be returned
\n
"
required: false
schema:
type: integer
time_anch_VI06:
name: time_anch
in: query
description: 'The median number of days spent at anchorage by the selected market/shipclass.
Values indicate in between set to be returned Comma separated float
numbers (one decimal)
Available only if extended version of the API is used'
required: false
schema:
type: string
time_port_VI06:
name: time_port
in: query
description: The median number of days spent at port by the selected market/shipclass. Values indicate in between set
to be returned Comma separated float numbers (one decimal) Available only if extended version
of the API is used
required: false
schema:
type: string
vessels_VI06:
name: vessels
in: query
description: Number of vessels that were used in the median calculations. Value of parameter indicates greater than
relation Available only if extended version of the API is used
required: false
schema:
type: integer
calls_VI06:
name: calls
in: query
description: Number of individual calls that were used in the median calculations (e.g. if the same vessel has called
twice within the same week, it will count twice in calls and once in vessels. Value of parameter indicates greater
than relation Available only if extended version of the API is used
required: false
schema:
type: integer
time_anch_stdev_VI06:
name: time_anch_stdev
in: query
description: The standard deviation of days spent at anchorage the previous week. Values indicate in between set to
be returned (time_anch_stdev:0.5,1.5) Comma separated float numbers (one decimal) Available
only if full version of the API is used
required: false
schema:
type: string
time_anch_diff_VI06:
name: time_anch_diff
in: query
description: The week-to-week difference of number of days spent at anchorage. Values indicate in between set to be
returned Comma separated float numbers (one decimal) Available only if full version of the
API is used
required: false
schema:
type: string
time_anch_diff_perc_VI06:
name: time_anch_diff_perc
in: query
description: The week-to-week difference of number of days spent at anchorage as a percentage. Values indicate in between
set to be returned Comma separated float numbers (one decimal) Available only if full version
of the API is used
required: false
schema:
type: string
time_port_stdev_VI06:
name: time_port_stdev
in: query
description: The standard deviation of days spent at port the previous week. Values indicate in between set to be returned
(time_port_stdev:0.5,1.5) Comma separated float numbers (one decimal) Available only if full
version of the API is used
required: false
schema:
type: string
time_port_diff_VI06:
name: time_port_diff
in: query
description: The week-to-week difference of number of days spent at port. Values indicate in between set to be returned
Comma separated float numbers (one decimal) Available only if full version of the API is used
required: false
schema:
type: string
time_port_diff_perc_VI06:
name: time_port_diff_perc
in: query
description: The week-to-week difference of number of days spent at port as a percentage. Values indicate in between
set to be returned Comma separated float numbers (one decimal) Available only if full version
of the API is used
required: false
schema:
type: string
mmsi_VI03:
name: mmsi
in: query
description: The Maritime Mobile Service Identity (MMSI) of the vessel you wish to track You can instead
use imo or shipid
required: true
schema:
type: integer
imo_VI03:
name: imo
in: query
description: The International Maritime Organization (IMO) number of the vessel you wish to track
required: false
schema:
type: integer
shipid_VI03:
name: shipid
in: query
description: A uniquely assigned ID by MarineTraffic for the subject vessel
required: false
schema:
type: integer
port_target_id_VI03:
name: port_target_id
in: query
description: The MarineTraffic ID of the port you wish to put as target port (found on the URL of the respective Port
page) or port UN/LOCODE
required: true
schema:
type: integer
includealternatives_VI03:
name: includealternatives
in: query
description: Use 1 to search for all available routes regarding the specific journey or 0 to not include alternative
routes
required: false
schema:
type: integer
includeinland_VI03:
name: includeinland
in: query
description: Use 1 in order to receive routes which include inland waterways or 0 to not include alternative routes
required: false
schema:
type: integer
msgtype_VI03:
name: msgtype
in: query
description: "Resolution of the response. Available values: If used\
\ with the value extended, the response includes also route/waypoints as Linestring Geometry in WKT - Well-Known\
\ Text"
required: false
schema:
type: string
default: simple
port_start_id_VI03:
name: port_start_id
in: query
description: The MarineTraffic ID of the port you wish to put as starting point (found on the URL of the respective
Port page) or port UN/LOCODE
required: true
schema:
type: integer
LAT_VI03:
name: LAT
in: query
description: The latitude of the starting point It can be used together with LON instead of port_start_id
required: false
schema:
type: number
LON_VI03:
name: LON
in: query
description: The longitude of the starting point It can be used together with LAT instead of port_start_id
required: false
schema:
type: integer
coordinates_GI01:
name: coordinates
in: query
description: A latitude/longitude pair that you wish to receive the MarineTraffic areas/assets that intersects with
required: true
schema:
type: string
radius_GI01:
name: radius
in: query
description: Maximum distance (in NM) from the given point that should be searched for nearby areas/assets
Cannot be greater than 10NM
required: false
schema:
type: number
exclude_ports_GI01:
name: exclude_ports
in: query
description: Flag that indicates if Ports information will be excluded from response in case given point intersects
with them (0:no, 1:yes)
required: false
schema:
type: integer
exclude_berths_GI01:
name: exclude_berths
in: query
description: Flag that indicates if Berths information will be excluded from response in case given point intersects
with them (0:no, 1:yes)
required: false
schema:
type: integer
exclude_terminals_GI01:
name: exclude_terminals
in: query
description: Flag that indicates if Terminals information will be excluded from response in case given point intersects
with them (0:no, 1:yes)
required: false
schema:
type: integer
exclude_standard_areas_GI01:
name: exclude_standard_areas
in: query
description: Flag that indicates if Standard Areas information will be excluded from response in case given point intersects
with them (0:no, 1:yes)
required: false
schema:
type: integer
exclude_custom_areas_GI01:
name: exclude_custom_areas
in: query
description: Flag that indicates if Custom Areas information will be excluded from response in case given point intersects
with them (0:no, 1:yes)
required: false
schema:
type: integer
mmsi_PU01:
name: mmsi
in: query
description: The Maritime Mobile Service Identity (MMSI) of the vessel you wish to handle, comma separated values supported
You can instead use imo or shipid
required: true
schema:
type: integer
imo_PU01:
name: imo
in: query
description: The International Maritime Organization (IMO) number of the vessel you wish to handle, comma separated
values supported
required: false
schema:
type: integer
shipid_PU01:
name: shipid
in: query
description: A uniquely assigned ID by MarineTraffic for the subject vessel, comma separated values supported
required: false
schema:
type: integer
fleet_id_PU01:
name: fleet_id
in: query
description: If used, vessel will be added to the specific fleet, otherwise default fleet is used
required: false
schema:
type: integer
active_PU01:
name: active
in: query
description: "Possible values are: \n - 0 to set to inactive
\n - 1 to activate
\n - 2 to enable\
\ satellite coverage
\n
"
required: false
schema:
type: integer
delete_PU01:
name: delete
in: query
description: Set this parameter to 1 to delete a vessel from your fleet
required: false
schema:
type: integer
v_PU02:
name: v
in: query
description: Version of the service to be executed. Use version 2 to get the latest
required: true
schema:
type: integer
default: 1
fleet_id_PU02:
name: fleet_id
in: query
description: If used, will return specific fleet otherwise default fleet is used
required: false
schema:
type: integer
page_PU02:
name: page
in: query
description: Specifies the number of the results page to return. Use this parameter to navigate through paginated results
(with version 2) when the fleet contains more than 100 vessels.
required: false
schema:
type: integer
fleet_id_PU05:
name: fleet_id
in: query
description: The fleet id you wish to clear
required: true
schema:
type: integer
content_type_pu06:
name: Content-Type
in: header
description: Request's Content-Type
required: true
schema:
type: string
default: multipart/form-data
schemas:
429_too_many_requests:
title: Too many requests
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: string
description: Error code
detail:
type: string
description: Error message
example:
errors:
- code: 1r
detail: TOO MANY REQUESTS
200_ps01_default:
title: Simple
type: array
items:
type: object
properties:
MMSI:
type: string
description: Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency
that identifies the vessel's transmitter station
IMO:
type: string
description: International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
STATUS:
type: string
description: The AIS Navigational Status of the subject vessel as input by the vessel's crew. There might be discrepancies
with the vessel's detail page when vessel speed is near zero (0) knots
SPEED:
type: string
description: The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
LON:
type: string
description: Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's
surface
LAT:
type: string
description: Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's
surface
COURSE:
type: string
description: The course (in degrees) that the subject vessel is reporting according to AIS transmissions
HEADING:
type: string
description: The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
TIMESTAMP:
type: string
description: The date and time (in UTC) that the subject vessel's position or event was recorded by MarineTraffic
format: date-time
SHIP_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the subject vessel
example:
- MMSI: '239982500'
IMO: '8348678'
STATUS: '5'
SPEED: '0'
LON: '23.726880'
LAT: '37.878850'
COURSE: '0'
HEADING: '320'
TIMESTAMP: '2021-02-08T12:57:01.000Z'
SHIP_ID: '4317723'
- MMSI: '249032000'
IMO: '9351098'
STATUS: '15'
SPEED: '2'
LON: '23.548990'
LAT: '37.903030'
COURSE: '160'
HEADING: '160'
TIMESTAMP: '2021-02-08T12:57:05.000Z'
SHIP_ID: '362849'
200_ps01_extended:
title: Extended
type: array
items:
type: object
properties:
MMSI:
type: string
description: Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency
that identifies the vessel's transmitter station
IMO:
type: string
description: International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
STATUS:
type: string
description: The AIS Navigational Status of the subject vessel as input by the vessel's crew. There might be discrepancies
with the vessel's detail page when vessel speed is near zero (0) knots
SPEED:
type: string
description: The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
LON:
type: string
description: Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's
surface
LAT:
type: string
description: Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's
surface
COURSE:
type: string
description: The course (in degrees) that the subject vessel is reporting according to AIS transmissions
HEADING:
type: string
description: The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
TIMESTAMP:
type: string
description: The date and time (in UTC) that the subject vessel's position or event was recorded by MarineTraffic
format: date-time
SHIP_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the subject vessel
WIND_ANGLE:
type: string
description: The current angle of the wind in the subject area (in degrees, compared to True North)
WIND_SPEED:
type: string
description: The current wind speed in the subject area (in knots)
WIND_TEMP:
type: string
description: The current temperature of the wind in the subject area (in Celsius degrees)
SIGNIFICANT_WAVE_HEIGHT:
type: string
description: The significant wave height in the subject area (in meters x10)
WIND_WAVE_HEIGHT:
type: string
description: The height of the wind waves in the subjects area (in meters x10)
WIND_WAVE_PERIOD:
type: string
description: The period of the wind waves in the subject area (in seconds)
WIND_WAVE_DIRECTION:
type: string
description: The direction of the wind waves in the subject area (in degrees, compared to True North)
SWELL_HEIGHT:
type: string
description: The height of the swells in the subject area (in meters x10)
SWELL_PERIOD:
type: string
description: The period of the swells in the subject area (in seconds)
SWELL_DIRECTION:
type: string
description: The direction of the swells in the subject area (in degrees, compared to True North)
CURRENTS_ANGLE:
type: string
description: The angle of the currents in the subject area (in degrees, compared to True North)
CURRENTS_SPEED:
type: string
description: The speed of the currents in the subject area (in knots x100)
example:
- MMSI: '239982500'
IMO: '8348678'
STATUS: '5'
SPEED: '0'
LON: '23.726880'
LAT: '37.878850'
COURSE: '0'
HEADING: '320'
TIMESTAMP: '2021-02-08T12:57:01.000Z'
SHIP_ID: '4317723'
WIND_ANGLE: '326'
WIND_SPEED: '10'
WIND_TEMP: '23'
SIGNIFICANT_WAVE_HEIGHT: '2'
WIND_WAVE_DIRECTION: '314'
WIND_WAVE_HEIGHT: '1'
WIND_WAVE_PERIOD: '16'
SWELL_HEIGHT: '1'
SWELL_PERIOD: '26'
CURRENTS_ANGLE: '308'
CURRENTS_SPEED: '20'
SWELL_DIRECTION: '317'
- MMSI: '249032000'
IMO: '9351098'
STATUS: '15'
SPEED: '2'
LON: '23.548990'
LAT: '37.903030'
COURSE: '160'
HEADING: '160'
TIMESTAMP: '2021-02-08T12:57:05.000Z'
SHIP_ID: '362849'
WIND_ANGLE: '333'
WIND_SPEED: '12'
WIND_TEMP: '23'
SIGNIFICANT_WAVE_HEIGHT: '3'
WIND_WAVE_DIRECTION: '320'
WIND_WAVE_HEIGHT: '3'
WIND_WAVE_PERIOD: '24'
SWELL_HEIGHT: '0'
SWELL_PERIOD: '31'
CURRENTS_ANGLE: '21'
CURRENTS_SPEED: '20'
SWELL_DIRECTION: '303'
400_ps01_days_out_of_limit:
title: Days out of limit
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: string
description: Error code
detail:
type: string
description: Error message
example:
errors:
- code: 9c
detail: DAYS ABOVE ALLOWED LIMIT
400_ps01_missing_ship_identifier:
title: Missing ship identifier
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: string
description: Error code
detail:
type: string
description: Error message
example:
errors:
- code: '2'
detail: VESSEL MMSI OR IMO OR SHIPID MISSING
400_ps01_area_out_of_bound:
title: Area out of bound
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: string
description: Error code
detail:
type: string
description: Error message
example:
errors:
- code: 1k
detail: BOX OUT OF BOUNDS
200_ps02_default:
title: Simple
type: array
items:
type: object
properties:
MMSI:
type: string
description: Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency
that identifies the vessel's transmitter station
IMO:
type: string
description: International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the subject vessel
LAT:
type: string
description: Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's
surface
LON:
type: string
description: Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's
surface
SPEED:
type: string
description: The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING:
type: string
description: The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE:
type: string
description: The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS:
type: string
description: The AIS Navigational Status of the subject vessel as input by the vessel's crew. There might be discrepancies
with the vessel's detail page when vessel speed is near zero (0) knots
TIMESTAMP:
type: string
description: The date and time (in UTC) that the subject vessel's position or event was recorded by MarineTraffic
format: date-time
DSRC:
type: string
description: Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite
AIS Station
UTC_SECONDS:
type: string
description: The time slot that the subject vessel uses to transmit information
example:
- MMSI: '240389000'
IMO: '9208679'
SHIP_ID: '212537'
LAT: '37.512420'
LON: '24.913050'
SPEED: '229'
HEADING: '294'
COURSE: '295'
STATUS: '0'
TIMESTAMP: '2020-10-13T07:49:57.000Z'
DSRC: TER
UTC_SECONDS: '55'
- MMSI: '310627000'
IMO: '9241061'
SHIP_ID: '371681'
LAT: '50.510430'
LON: '-3.453147'
SPEED: '4'
HEADING: '276'
COURSE: '236'
STATUS: '1'
TIMESTAMP: '2020-10-13T07:48:16.000Z'
DSRC: TER
UTC_SECONDS: '16'
200_ps02_extended:
title: Extended
type: array
items:
type: object
properties:
MMSI:
type: string
description: Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency
that identifies the vessel's transmitter station
IMO:
type: string
description: International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the subject vessel
LAT:
type: string
description: Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's
surface
LON:
type: string
description: Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's
surface
SPEED:
type: string
description: The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING:
type: string
description: The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE:
type: string
description: The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS:
type: string
description: The AIS Navigational Status of the subject vessel as input by the vessel's crew. There might be discrepancies
with the vessel's detail page when vessel speed is near zero (0) knots
TIMESTAMP:
type: string
description: The date and time (in UTC) that the subject vessel's position or event was recorded by MarineTraffic
format: date-time
DSRC:
type: string
description: Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite
AIS Station
UTC_SECONDS:
type: string
description: The time slot that the subject vessel uses to transmit information
SHIPNAME:
type: string
description: The Shipname of the subject vessel
SHIPTYPE:
type: string
description: The Shiptype of the subject vessel according to AIS transmissions
CALLSIGN:
type: string
description: A uniquely designated identifier for the vessel's transmitter station
FLAG:
type: string
description: The flag of the subject vessel according to AIS transmissions
LENGTH:
type: string
description: The overall Length (in metres) of the subject vessel
WIDTH:
type: string
description: The Breadth (in metres) of the subject vessel
GRT:
type: string
description: Gross Tonnage - unitless measure that calculates the moulded volume of all enclosed spaces of a ship
DWT:
type: string
description: Deadweight - a measure (in metric tons) of how much weight a vessel can safely carry (excluding the
vessel's own weight)
DRAUGHT:
type: string
description: The Draught (in metres x10) of the subject vessel according to the AIS transmissions
YEAR_BUILT:
type: string
description: The year that the subject vessel was built
ROT:
type: string
description: Rate of Turn
TYPE_NAME:
type: string
description: The Type of the subject vessel
AIS_TYPE_SUMMARY:
type: string
description: Further explanation of the SHIPTYPE ID
DESTINATION:
type: string
description: The Destination of the subject vessel according to the AIS transmissions
ETA:
type: string
description: The Estimated Time of Arrival to Destination of the subject vessel according to the AIS transmissions
format: date-time
example:
- MMSI: '240389000'
IMO: '9208679'
SHIP_ID: '212537'
LAT: '37.659450'
LON: '26.497440'
SPEED: '222'
HEADING: '205'
COURSE: '208'
STATUS: '0'
TIMESTAMP: '2020-10-15T11:47:03.000Z'
DSRC: TER
UTC_SECONDS: '0'
SHIPNAME: BLUE STAR MYCONOS
SHIPTYPE: '60'
CALLSIGN: SYJZ
FLAG: GR
LENGTH: '141'
WIDTH: '21'
GRT: '8129'
DWT: '2651'
DRAUGHT: '52'
YEAR_BUILT: '2005'
ROT: '0'
TYPE_NAME: Ro-Ro/Passenger Ship
AIS_TYPE_SUMMARY: Passenger
DESTINATION: S-T-M-E-K-V
ETA: '2020-10-15T11:35:00.000Z'
- MMSI: '310627000'
IMO: '9241061'
SHIP_ID: '371681'
LAT: '50.495310'
LON: '-3.182992'
SPEED: '111'
HEADING: '280'
COURSE: '274'
STATUS: '0'
TIMESTAMP: '2020-10-15T11:47:17.000Z'
DSRC: TER
UTC_SECONDS: '16'
SHIPNAME: QUEEN MARY 2
SHIPTYPE: '60'
CALLSIGN: ZCEF6
FLAG: BM
LENGTH: '345.03'
WIDTH: '48.7'
GRT: '149215'
DWT: '19189'
DRAUGHT: '101'
YEAR_BUILT: '2003'
ROT: '0'
TYPE_NAME: Passenger Ship
AIS_TYPE_SUMMARY: Passenger
DESTINATION: TORQUAY
ETA: '2020-10-14T13:00:00.000Z'
200_ps02_full:
title: Full
type: array
items:
type: object
properties:
MMSI:
type: string
description: Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency
that identifies the vessel's transmitter station
IMO:
type: string
description: International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the subject vessel
LAT:
type: string
description: Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's
surface
LON:
type: string
description: Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's
surface
SPEED:
type: string
description: The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING:
type: string
description: The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE:
type: string
description: The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS:
type: string
description: The AIS Navigational Status of the subject vessel as input by the vessel's crew. There might be discrepancies
with the vessel's detail page when vessel speed is near zero (0) knots
TIMESTAMP:
type: string
description: The date and time (in UTC) that the subject vessel's position or event was recorded by MarineTraffic
format: date-time
DSRC:
type: string
description: Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite
AIS Station
UTC_SECONDS:
type: string
description: The time slot that the subject vessel uses to transmit information
SHIPNAME:
type: string
description: The Shipname of the subject vessel
SHIPTYPE:
type: string
description: The Shiptype of the subject vessel according to AIS transmissions
CALLSIGN:
type: string
description: A uniquely designated identifier for the vessel's transmitter station
FLAG:
type: string
description: The flag of the subject vessel according to AIS transmissions
LENGTH:
type: string
description: The overall Length (in metres) of the subject vessel
WIDTH:
type: string
description: The Breadth (in metres) of the subject vessel
GRT:
type: string
description: Gross Tonnage - unitless measure that calculates the moulded volume of all enclosed spaces of a ship
DWT:
type: string
description: Deadweight - a measure (in metric tons) of how much weight a vessel can safely carry (excluding the
vessel's own weight)
DRAUGHT:
type: string
description: The Draught (in metres x10) of the subject vessel according to the AIS transmissions
YEAR_BUILT:
type: string
description: The year that the subject vessel was built
ROT:
type: string
description: Rate of Turn
TYPE_NAME:
type: string
description: The Type of the subject vessel
AIS_TYPE_SUMMARY:
type: string
description: Further explanation of the SHIPTYPE ID
DESTINATION:
type: string
description: The Destination of the subject vessel according to the AIS transmissions
ETA:
type: string
description: The Estimated Time of Arrival to Destination of the subject vessel according to the AIS transmissions
format: date-time
CURRENT_PORT:
type: string
description: The name of the Port the subject vessel is currently in (NULL if the vessel is underway)
LAST_PORT:
type: string
description: The Name of the Last Port the vessel has visited
LAST_PORT_TIME:
type: string
description: The Date and Time (in UTC) that the subject vessel departed from the Last Port
format: date-time
CURRENT_PORT_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the Current Port
CURRENT_PORT_UNLOCODE:
type: string
description: A uniquely assigned ID by United Nations for the Current Port
CURRENT_PORT_COUNTRY:
type: string
description: The Country that the Current Port is located at
LAST_PORT_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the Last Port
LAST_PORT_UNLOCODE:
type: string
description: A uniquely assigned ID by United Nations for the Last Port
LAST_PORT_COUNTRY:
type: string
description: The Country that the Last Port is located at
NEXT_PORT_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the Next Port
NEXT_PORT_UNLOCODE:
type: string
description: A uniquely assigned ID by United Nations for the Next Port.
NEXT_PORT_NAME:
type: string
description: The Name of the Next Port as derived by MarineTraffic based on the subject vessel's reported Destination
NEXT_PORT_COUNTRY:
type: string
description: The Country that the Next Port is located at
ETA_CALC:
type: string
description: The Estimated Time of Arrival to Destination of the subject vessel according to the MarineTraffic
calculations
format: date-time
ETA_UPDATED:
type: string
description: The date and time (in UTC) that the ETA was calculated by MarineTraffic
format: date-time
DISTANCE_TO_GO:
type: string
description: The Remaining Distance (in NM) for the subject vessel to reach the reported Destination
DISTANCE_TRAVELLED:
type: string
description: The Distance (in NM) that the subject vessel has travelled since departing from Last Port
AVG_SPEED:
type: string
description: The average speed of the vessel (in knots) during the current voyage (since last port departure),
calculated using AIS position readings from the last 24 hours where speed exceeds 5 knots.
MAX_SPEED:
type: string
description: The maximum speed (in knots) recorded during the current voyage (since last port departure). This
value updates gradually and may lag behind the current speed following a sudden acceleration or shortly after
port departure.
example:
- MMSI: '240389000'
IMO: '9208679'
SHIP_ID: '212537'
LAT: '37.646880'
LON: '26.488940'
SPEED: '223'
HEADING: '205'
COURSE: '208'
STATUS: '0'
TIMESTAMP: '2020-10-15T11:49:22.000Z'
DSRC: TER
UTC_SECONDS: '18'
SHIPNAME: BLUE STAR MYCONOS
SHIPTYPE: '60'
CALLSIGN: SYJZ
FLAG: GR
LENGTH: '141'
WIDTH: '21'
GRT: '8129'
DWT: '2651'
DRAUGHT: '52'
YEAR_BUILT: '2005'
ROT: '0'
TYPE_NAME: Ro-Ro/Passenger Ship
AIS_TYPE_SUMMARY: Passenger
DESTINATION: S-T-M-E-K-V
ETA: '2020-10-15T11:35:00.000Z'
CURRENT_PORT: ''
LAST_PORT: KARLOVASI
LAST_PORT_TIME: '2020-10-15T11:14:00.000Z'
CURRENT_PORT_ID: ''
CURRENT_PORT_UNLOCODE: ''
CURRENT_PORT_COUNTRY: ''
LAST_PORT_ID: '44'
LAST_PORT_UNLOCODE: GRKAR
LAST_PORT_COUNTRY: GR
NEXT_PORT_ID: '17305'
NEXT_PORT_UNLOCODE: ''
NEXT_PORT_NAME: FOURNI
NEXT_PORT_COUNTRY: GR
ETA_CALC: '2020-10-15T12:04:00.000Z'
ETA_UPDATED: '2020-10-15T11:42:00.000Z'
DISTANCE_TO_GO: '7'
DISTANCE_TRAVELLED: '11'
AVG_SPEED: '22.6'
MAX_SPEED: '23.1'
- MMSI: '310627000'
IMO: '9241061'
SHIP_ID: '371681'
LAT: '50.495970'
LON: '-3.195012'
SPEED: '110'
HEADING: '280'
COURSE: '275'
STATUS: '0'
TIMESTAMP: '2020-10-15T11:49:48.000Z'
DSRC: TER
UTC_SECONDS: '47'
SHIPNAME: QUEEN MARY 2
SHIPTYPE: '60'
CALLSIGN: ZCEF6
FLAG: BM
LENGTH: '345.03'
WIDTH: '48.7'
GRT: '149215'
DWT: '19189'
DRAUGHT: '101'
YEAR_BUILT: '2003'
ROT: '0'
TYPE_NAME: Passenger Ship
AIS_TYPE_SUMMARY: Passenger
DESTINATION: TORQUAY
ETA: '2020-10-14T13:00:00.000Z'
CURRENT_PORT: ''
LAST_PORT: SOUTHAMPTON
LAST_PORT_TIME: '2020-10-14T17:00:00.000Z'
CURRENT_PORT_ID: ''
CURRENT_PORT_UNLOCODE: ''
CURRENT_PORT_COUNTRY: ''
LAST_PORT_ID: '106'
LAST_PORT_UNLOCODE: GBSOU
LAST_PORT_COUNTRY: GB
NEXT_PORT_ID: '10379'
NEXT_PORT_UNLOCODE: GBTOR
NEXT_PORT_NAME: TORQUAY
NEXT_PORT_COUNTRY: GB
ETA_CALC: '2020-10-15T13:10:00.000Z'
ETA_UPDATED: '2020-10-15T10:48:00.000Z'
DISTANCE_TO_GO: '17'
DISTANCE_TRAVELLED: '190'
AVG_SPEED: '10.6'
MAX_SPEED: '15.4'
403_ps02_infinite_timespan:
title: Infinite timespan
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: string
description: Error code
detail:
type: string
description: Error message
example:
errors:
- code: 1d
detail: TIME-UNLIMITED POLLING NOT ALLOWED
200_ps03_default:
title: Simple
type: array
items:
type: object
properties:
MMSI:
type: string
description: Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency
that identifies the vessel's transmitter station
IMO:
type: string
description: International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the subject vessel
LAT:
type: string
description: Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's
surface
LON:
type: string
description: Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's
surface
SPEED:
type: string
description: The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING:
type: string
description: The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE:
type: string
description: The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS:
type: string
description: The AIS Navigational Status of the subject vessel as input by the vessel's crew. There might be discrepancies
with the vessel's detail page when vessel speed is near zero (0) knots
TIMESTAMP:
type: string
description: The date and time (in UTC) that the subject vessel's position or event was recorded by MarineTraffic
format: date-time
DSRC:
type: string
description: Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite
AIS Station
UTC_SECONDS:
type: string
description: The time slot that the subject vessel uses to transmit information
example:
- MMSI: '240389000'
IMO: '9208679'
SHIP_ID: '212537'
LAT: '37.515440'
LON: '24.904090'
SPEED: '229'
HEADING: '290'
COURSE: '292'
STATUS: '0'
TIMESTAMP: '2020-10-13T07:51:09.000Z'
DSRC: TER
UTC_SECONDS: '7'
- MMSI: '241159000'
IMO: '9565041'
SHIP_ID: '214617'
LAT: '37.941010'
LON: '23.624440'
SPEED: '1'
HEADING: '154'
COURSE: '154'
STATUS: '0'
TIMESTAMP: '2020-10-13T07:46:32.000Z'
DSRC: TER
UTC_SECONDS: '30'
200_ps03_extended:
title: Extended
type: array
items:
type: object
properties:
MMSI:
type: string
description: Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency
that identifies the vessel's transmitter station
IMO:
type: string
description: International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the subject vessel
LAT:
type: string
description: Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's
surface
LON:
type: string
description: Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's
surface
SPEED:
type: string
description: The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING:
type: string
description: The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE:
type: string
description: The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS:
type: string
description: The AIS Navigational Status of the subject vessel as input by the vessel's crew. There might be discrepancies
with the vessel's detail page when vessel speed is near zero (0) knots
TIMESTAMP:
type: string
description: The date and time (in UTC) that the subject vessel's position or event was recorded by MarineTraffic
format: date-time
DSRC:
type: string
description: Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite
AIS Station
UTC_SECONDS:
type: string
description: The time slot that the subject vessel uses to transmit information
SHIPNAME:
type: string
description: The Shipname of the subject vessel
SHIPTYPE:
type: string
description: The Shiptype of the subject vessel according to AIS transmissions
CALLSIGN:
type: string
description: A uniquely designated identifier for the vessel's transmitter station
FLAG:
type: string
description: The flag of the subject vessel according to AIS transmissions
LENGTH:
type: string
description: The overall Length (in metres) of the subject vessel
WIDTH:
type: string
description: The Breadth (in metres) of the subject vessel
GRT:
type: string
description: Gross Tonnage - unitless measure that calculates the moulded volume of all enclosed spaces of a ship
DWT:
type: string
description: Deadweight - a measure (in metric tons) of how much weight a vessel can safely carry (excluding the
vessel's own weight)
DRAUGHT:
type: string
description: The Draught (in metres x10) of the subject vessel according to the AIS transmissions
YEAR_BUILT:
type: string
description: The year that the subject vessel was built
ROT:
type: string
description: Rate of Turn
TYPE_NAME:
type: string
description: The Type of the subject vessel
AIS_TYPE_SUMMARY:
type: string
description: Further explanation of the SHIPTYPE ID
DESTINATION:
type: string
description: The Destination of the subject vessel according to the AIS transmissions
ETA:
type: string
description: The Estimated Time of Arrival to Destination of the subject vessel according to the AIS transmissions
format: date-time
example:
- MMSI: '240389000'
IMO: '9208679'
SHIP_ID: '212537'
LAT: '37.659450'
LON: '26.497440'
SPEED: '222'
HEADING: '205'
COURSE: '208'
STATUS: '0'
TIMESTAMP: '2020-10-15T11:47:03.000Z'
DSRC: TER
UTC_SECONDS: '0'
SHIPNAME: BLUE STAR MYCONOS
SHIPTYPE: '60'
CALLSIGN: SYJZ
FLAG: GR
LENGTH: '141'
WIDTH: '21'
GRT: '8129'
DWT: '2651'
DRAUGHT: '52'
YEAR_BUILT: '2005'
ROT: '0'
TYPE_NAME: Ro-Ro/Passenger Ship
AIS_TYPE_SUMMARY: Passenger
DESTINATION: S-T-M-E-K-V
ETA: '2020-10-15T11:35:00.000Z'
- MMSI: '310627000'
IMO: '9241061'
SHIP_ID: '371681'
LAT: '50.495310'
LON: '-3.182992'
SPEED: '111'
HEADING: '280'
COURSE: '274'
STATUS: '0'
TIMESTAMP: '2020-10-15T11:47:17.000Z'
DSRC: TER
UTC_SECONDS: '16'
SHIPNAME: QUEEN MARY 2
SHIPTYPE: '60'
CALLSIGN: ZCEF6
FLAG: BM
LENGTH: '345.03'
WIDTH: '48.7'
GRT: '149215'
DWT: '19189'
DRAUGHT: '101'
YEAR_BUILT: '2003'
ROT: '0'
TYPE_NAME: Passenger Ship
AIS_TYPE_SUMMARY: Passenger
DESTINATION: TORQUAY
ETA: '2020-10-14T13:00:00.000Z'
200_ps03_full:
title: Full
type: array
items:
type: object
properties:
MMSI:
type: string
description: Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency
that identifies the vessel's transmitter station
IMO:
type: string
description: International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the subject vessel
LAT:
type: string
description: Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's
surface
LON:
type: string
description: Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's
surface
SPEED:
type: string
description: The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING:
type: string
description: The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE:
type: string
description: The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS:
type: string
description: The AIS Navigational Status of the subject vessel as input by the vessel's crew. There might be discrepancies
with the vessel's detail page when vessel speed is near zero (0) knots
TIMESTAMP:
type: string
description: The date and time (in UTC) that the subject vessel's position or event was recorded by MarineTraffic
format: date-time
DSRC:
type: string
description: Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite
AIS Station
UTC_SECONDS:
type: string
description: The time slot that the subject vessel uses to transmit information
SHIPNAME:
type: string
description: The Shipname of the subject vessel
SHIPTYPE:
type: string
description: The Shiptype of the subject vessel according to AIS transmissions
CALLSIGN:
type: string
description: A uniquely designated identifier for the vessel's transmitter station
FLAG:
type: string
description: The flag of the subject vessel according to AIS transmissions
LENGTH:
type: string
description: The overall Length (in metres) of the subject vessel
WIDTH:
type: string
description: The Breadth (in metres) of the subject vessel
GRT:
type: string
description: Gross Tonnage - unitless measure that calculates the moulded volume of all enclosed spaces of a ship
DWT:
type: string
description: Deadweight - a measure (in metric tons) of how much weight a vessel can safely carry (excluding the
vessel's own weight)
DRAUGHT:
type: string
description: The Draught (in metres x10) of the subject vessel according to the AIS transmissions
YEAR_BUILT:
type: string
description: The year that the subject vessel was built
ROT:
type: string
description: Rate of Turn
TYPE_NAME:
type: string
description: The Type of the subject vessel
AIS_TYPE_SUMMARY:
type: string
description: Further explanation of the SHIPTYPE ID
DESTINATION:
type: string
description: The Destination of the subject vessel according to the AIS transmissions
ETA:
type: string
description: The Estimated Time of Arrival to Destination of the subject vessel according to the AIS transmissions
format: date-time
CURRENT_PORT:
type: string
description: The name of the Port the subject vessel is currently in (NULL if the vessel is underway)
LAST_PORT:
type: string
description: The Name of the Last Port the vessel has visited
LAST_PORT_TIME:
type: string
description: The Date and Time (in UTC) that the subject vessel departed from the Last Port
format: date-time
CURRENT_PORT_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the Current Port
CURRENT_PORT_UNLOCODE:
type: string
description: A uniquely assigned ID by United Nations for the Current Port
CURRENT_PORT_COUNTRY:
type: string
description: The Country that the Current Port is located at
LAST_PORT_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the Last Port
LAST_PORT_UNLOCODE:
type: string
description: A uniquely assigned ID by United Nations for the Last Port
LAST_PORT_COUNTRY:
type: string
description: The Country that the Last Port is located at
NEXT_PORT_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the Next Port
NEXT_PORT_UNLOCODE:
type: string
description: A uniquely assigned ID by United Nations for the Next Port.
NEXT_PORT_NAME:
type: string
description: The Name of the Next Port as derived by MarineTraffic based on the subject vessel's reported Destination
NEXT_PORT_COUNTRY:
type: string
description: The Country that the Next Port is located at
ETA_CALC:
type: string
description: The Estimated Time of Arrival to Destination of the subject vessel according to the MarineTraffic
calculations
format: date-time
ETA_UPDATED:
type: string
description: The date and time (in UTC) that the ETA was calculated by MarineTraffic
format: date-time
DISTANCE_TO_GO:
type: string
description: The Remaining Distance (in NM) for the subject vessel to reach the reported Destination
DISTANCE_TRAVELLED:
type: string
description: The Distance (in NM) that the subject vessel has travelled since departing from Last Port
AVG_SPEED:
type: string
description: The average speed of the vessel (in knots) during the current voyage (since last port departure),
calculated using AIS position readings from the last 24 hours where speed exceeds 5 knots.
MAX_SPEED:
type: string
description: The maximum speed (in knots) recorded during the current voyage (since last port departure). This
value updates gradually and may lag behind the current speed following a sudden acceleration or shortly after
port departure.
example:
- MMSI: '240389000'
IMO: '9208679'
SHIP_ID: '212537'
LAT: '37.646880'
LON: '26.488940'
SPEED: '223'
HEADING: '205'
COURSE: '208'
STATUS: '0'
TIMESTAMP: '2020-10-15T11:49:22.000Z'
DSRC: TER
UTC_SECONDS: '18'
SHIPNAME: BLUE STAR MYCONOS
SHIPTYPE: '60'
CALLSIGN: SYJZ
FLAG: GR
LENGTH: '141'
WIDTH: '21'
GRT: '8129'
DWT: '2651'
DRAUGHT: '52'
YEAR_BUILT: '2005'
ROT: '0'
TYPE_NAME: Ro-Ro/Passenger Ship
AIS_TYPE_SUMMARY: Passenger
DESTINATION: S-T-M-E-K-V
ETA: '2020-10-15T11:35:00.000Z'
CURRENT_PORT: ''
LAST_PORT: KARLOVASI
LAST_PORT_TIME: '2020-10-15T11:14:00.000Z'
CURRENT_PORT_ID: ''
CURRENT_PORT_UNLOCODE: ''
CURRENT_PORT_COUNTRY: ''
LAST_PORT_ID: '44'
LAST_PORT_UNLOCODE: GRKAR
LAST_PORT_COUNTRY: GR
NEXT_PORT_ID: '17305'
NEXT_PORT_UNLOCODE: ''
NEXT_PORT_NAME: FOURNI
NEXT_PORT_COUNTRY: GR
ETA_CALC: '2020-10-15T12:04:00.000Z'
ETA_UPDATED: '2020-10-15T11:42:00.000Z'
DISTANCE_TO_GO: '7'
DISTANCE_TRAVELLED: '11'
AVG_SPEED: '22.6'
MAX_SPEED: '23.1'
- MMSI: '310627000'
IMO: '9241061'
SHIP_ID: '371681'
LAT: '50.495970'
LON: '-3.195012'
SPEED: '110'
HEADING: '280'
COURSE: '275'
STATUS: '0'
TIMESTAMP: '2020-10-15T11:49:48.000Z'
DSRC: TER
UTC_SECONDS: '47'
SHIPNAME: QUEEN MARY 2
SHIPTYPE: '60'
CALLSIGN: ZCEF6
FLAG: BM
LENGTH: '345.03'
WIDTH: '48.7'
GRT: '149215'
DWT: '19189'
DRAUGHT: '101'
YEAR_BUILT: '2003'
ROT: '0'
TYPE_NAME: Passenger Ship
AIS_TYPE_SUMMARY: Passenger
DESTINATION: TORQUAY
ETA: '2020-10-14T13:00:00.000Z'
CURRENT_PORT: ''
LAST_PORT: SOUTHAMPTON
LAST_PORT_TIME: '2020-10-14T17:00:00.000Z'
CURRENT_PORT_ID: ''
CURRENT_PORT_UNLOCODE: ''
CURRENT_PORT_COUNTRY: ''
LAST_PORT_ID: '106'
LAST_PORT_UNLOCODE: GBSOU
LAST_PORT_COUNTRY: GB
NEXT_PORT_ID: '10379'
NEXT_PORT_UNLOCODE: GBTOR
NEXT_PORT_NAME: TORQUAY
NEXT_PORT_COUNTRY: GB
ETA_CALC: '2020-10-15T13:10:00.000Z'
ETA_UPDATED: '2020-10-15T10:48:00.000Z'
DISTANCE_TO_GO: '17'
DISTANCE_TRAVELLED: '190'
AVG_SPEED: '10.6'
MAX_SPEED: '15.4'
200_ps04_default:
title: Simple
type: array
items:
type: object
properties:
MMSI:
type: string
description: Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency
that identifies the vessel's transmitter station
IMO:
type: string
description: International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the subject vessel
LAT:
type: string
description: Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's
surface
LON:
type: string
description: Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's
surface
SPEED:
type: string
description: The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING:
type: string
description: The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE:
type: string
description: The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS:
type: string
description: The AIS Navigational Status of the subject vessel as input by the vessel's crew. There might be discrepancies
with the vessel's detail page when vessel speed is near zero (0) knots
TIMESTAMP:
type: string
description: The date and time (in UTC) that the subject vessel's position or event was recorded by MarineTraffic
format: date-time
DSRC:
type: string
description: Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite
AIS Station
UTC_SECONDS:
type: string
description: The time slot that the subject vessel uses to transmit information
example:
- MMSI: '244830406'
IMO: '0'
SHIP_ID: '253535'
LAT: '52.371040'
LON: '4.888482'
SPEED: '0'
HEADING: '511'
COURSE: '0'
STATUS: '5'
TIMESTAMP: '2020-10-13T07:49:59.000Z'
DSRC: TER
UTC_SECONDS: '59'
- MMSI: '244780352'
IMO: '0'
SHIP_ID: '250936'
LAT: '52.377110'
LON: '4.900798'
SPEED: '2'
HEADING: '511'
COURSE: '16'
STATUS: '7'
TIMESTAMP: '2020-10-13T07:49:59.000Z'
DSRC: TER
UTC_SECONDS: '59'
200_ps04_extended:
title: Extended
type: array
items:
type: object
properties:
MMSI:
type: string
description: Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency
that identifies the vessel's transmitter station
IMO:
type: string
description: International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the subject vessel
LAT:
type: string
description: Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's
surface
LON:
type: string
description: Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's
surface
SPEED:
type: string
description: The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING:
type: string
description: The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE:
type: string
description: The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS:
type: string
description: The AIS Navigational Status of the subject vessel as input by the vessel's crew. There might be discrepancies
with the vessel's detail page when vessel speed is near zero (0) knots
TIMESTAMP:
type: string
description: The date and time (in UTC) that the subject vessel's position or event was recorded by MarineTraffic
format: date-time
DSRC:
type: string
description: Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite
AIS Station
UTC_SECONDS:
type: string
description: The time slot that the subject vessel uses to transmit information
SHIPNAME:
type: string
description: The Shipname of the subject vessel
SHIPTYPE:
type: string
description: The Shiptype of the subject vessel according to AIS transmissions
CALLSIGN:
type: string
description: A uniquely designated identifier for the vessel's transmitter station
FLAG:
type: string
description: The flag of the subject vessel according to AIS transmissions
LENGTH:
type: string
description: The overall Length (in metres) of the subject vessel
WIDTH:
type: string
description: The Breadth (in metres) of the subject vessel
GRT:
type: string
description: Gross Tonnage - unitless measure that calculates the moulded volume of all enclosed spaces of a ship
DWT:
type: string
description: Deadweight - a measure (in metric tons) of how much weight a vessel can safely carry (excluding the
vessel's own weight)
DRAUGHT:
type: string
description: The Draught (in metres x10) of the subject vessel according to the AIS transmissions
YEAR_BUILT:
type: string
description: The year that the subject vessel was built
ROT:
type: string
description: Rate of Turn
TYPE_NAME:
type: string
description: The Type of the subject vessel
AIS_TYPE_SUMMARY:
type: string
description: Further explanation of the SHIPTYPE ID
DESTINATION:
type: string
description: The Destination of the subject vessel according to the AIS transmissions
ETA:
type: string
description: The Estimated Time of Arrival to Destination of the subject vessel according to the AIS transmissions
format: date-time
example:
- MMSI: '244750688'
IMO: '0'
SHIP_ID: '1496'
LAT: '52.392240'
LON: '4.886143'
SPEED: '0'
HEADING: '511'
COURSE: '244'
STATUS: '0'
TIMESTAMP: '2020-10-15T12:12:20.000Z'
DSRC: TER
UTC_SECONDS: '21'
SHIPNAME: IJVEER 52
SHIPTYPE: '60'
CALLSIGN: PH2792
FLAG: NL
LENGTH: '28.6'
WIDTH: '9'
GRT: ''
DWT: ''
DRAUGHT: '24'
YEAR_BUILT: ''
ROT: '0'
TYPE_NAME: Inland, Ferry
AIS_TYPE_SUMMARY: Passenger
DESTINATION: ''
ETA: ''
- MMSI: '244750690'
IMO: '0'
SHIP_ID: '1498'
LAT: '52.400910'
LON: '4.891057'
SPEED: '0'
HEADING: '511'
COURSE: '7'
STATUS: '0'
TIMESTAMP: '2020-10-15T12:12:31.000Z'
DSRC: TER
UTC_SECONDS: '22'
SHIPNAME: IJVEER 56
SHIPTYPE: '60'
CALLSIGN: PB7406
FLAG: NL
LENGTH: '28.6'
WIDTH: '9'
GRT: ''
DWT: ''
DRAUGHT: '24'
YEAR_BUILT: ''
ROT: '0'
TYPE_NAME: Inland, Ferry
AIS_TYPE_SUMMARY: Passenger
DESTINATION: ''
ETA: ''
200_ps04_full:
title: Full
type: array
items:
type: object
properties:
MMSI:
type: string
description: Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency
that identifies the vessel's transmitter station
IMO:
type: string
description: International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the subject vessel
LAT:
type: string
description: Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's
surface
LON:
type: string
description: Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's
surface
SPEED:
type: string
description: The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING:
type: string
description: The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE:
type: string
description: The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS:
type: string
description: The AIS Navigational Status of the subject vessel as input by the vessel's crew. There might be discrepancies
with the vessel's detail page when vessel speed is near zero (0) knots
TIMESTAMP:
type: string
description: The date and time (in UTC) that the subject vessel's position or event was recorded by MarineTraffic
format: date-time
DSRC:
type: string
description: Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite
AIS Station
UTC_SECONDS:
type: string
description: The time slot that the subject vessel uses to transmit information
SHIPNAME:
type: string
description: The Shipname of the subject vessel
SHIPTYPE:
type: string
description: The Shiptype of the subject vessel according to AIS transmissions
CALLSIGN:
type: string
description: A uniquely designated identifier for the vessel's transmitter station
FLAG:
type: string
description: The flag of the subject vessel according to AIS transmissions
LENGTH:
type: string
description: The overall Length (in metres) of the subject vessel
WIDTH:
type: string
description: The Breadth (in metres) of the subject vessel
GRT:
type: string
description: Gross Tonnage - unitless measure that calculates the moulded volume of all enclosed spaces of a ship
DWT:
type: string
description: Deadweight - a measure (in metric tons) of how much weight a vessel can safely carry (excluding the
vessel's own weight)
DRAUGHT:
type: string
description: The Draught (in metres x10) of the subject vessel according to the AIS transmissions
YEAR_BUILT:
type: string
description: The year that the subject vessel was built
ROT:
type: string
description: Rate of Turn
TYPE_NAME:
type: string
description: The Type of the subject vessel
AIS_TYPE_SUMMARY:
type: string
description: Further explanation of the SHIPTYPE ID
DESTINATION:
type: string
description: The Destination of the subject vessel according to the AIS transmissions
ETA:
type: string
description: The Estimated Time of Arrival to Destination of the subject vessel according to the AIS transmissions
format: date-time
CURRENT_PORT:
type: string
description: The name of the Port the subject vessel is currently in (NULL if the vessel is underway)
LAST_PORT:
type: string
description: The Name of the Last Port the vessel has visited
LAST_PORT_TIME:
type: string
description: The Date and Time (in UTC) that the subject vessel departed from the Last Port
format: date-time
CURRENT_PORT_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the Current Port
CURRENT_PORT_UNLOCODE:
type: string
description: A uniquely assigned ID by United Nations for the Current Port
CURRENT_PORT_COUNTRY:
type: string
description: The Country that the Current Port is located at
LAST_PORT_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the Last Port
LAST_PORT_UNLOCODE:
type: string
description: A uniquely assigned ID by United Nations for the Last Port
LAST_PORT_COUNTRY:
type: string
description: The Country that the Last Port is located at
NEXT_PORT_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the Next Port
NEXT_PORT_UNLOCODE:
type: string
description: A uniquely assigned ID by United Nations for the Next Port.
NEXT_PORT_NAME:
type: string
description: The Name of the Next Port as derived by MarineTraffic based on the subject vessel's reported Destination
NEXT_PORT_COUNTRY:
type: string
description: The Country that the Next Port is located at
ETA_CALC:
type: string
description: The Estimated Time of Arrival to Destination of the subject vessel according to the MarineTraffic
calculations
format: date-time
ETA_UPDATED:
type: string
description: The date and time (in UTC) that the ETA was calculated by MarineTraffic
format: date-time
DISTANCE_TO_GO:
type: string
description: The Remaining Distance (in NM) for the subject vessel to reach the reported Destination
DISTANCE_TRAVELLED:
type: string
description: The Distance (in NM) that the subject vessel has travelled since departing from Last Port
AVG_SPEED:
type: string
description: The average speed of the vessel (in knots) during the current voyage (since last port departure),
calculated using AIS position readings from the last 24 hours where speed exceeds 5 knots.
MAX_SPEED:
type: string
description: The maximum speed (in knots) recorded during the current voyage (since last port departure). This
value updates gradually and may lag behind the current speed following a sudden acceleration or shortly after
port departure.
example:
- MMSI: '244740307'
IMO: '0'
SHIP_ID: '538'
LAT: '52.392770'
LON: '4.823317'
SPEED: '0'
HEADING: '511'
COURSE: '306'
STATUS: '0'
TIMESTAMP: '2020-10-15T12:14:45.000Z'
DSRC: TER
UTC_SECONDS: '45'
SHIPNAME: WABO
SHIPTYPE: '70'
CALLSIGN: PE6642
FLAG: NL
LENGTH: '46'
WIDTH: '6'
GRT: ''
DWT: ''
DRAUGHT: '26'
YEAR_BUILT: ''
ROT: '0'
TYPE_NAME: Inland, Bunkership
AIS_TYPE_SUMMARY: Tanker
DESTINATION: AMSTERDAM
ETA: '2021-02-09T00:00:00.000Z'
CURRENT_PORT: AMSTERDAM
LAST_PORT: ZAANDAM
LAST_PORT_TIME: '2020-08-09T10:27:00.000Z'
CURRENT_PORT_ID: '1766'
CURRENT_PORT_UNLOCODE: NLAMS
CURRENT_PORT_COUNTRY: NL
LAST_PORT_ID: '2141'
LAST_PORT_UNLOCODE: NLZAA
LAST_PORT_COUNTRY: NL
NEXT_PORT_ID: '1766'
NEXT_PORT_UNLOCODE: NLAMS
NEXT_PORT_NAME: AMSTERDAM
NEXT_PORT_COUNTRY: NL
ETA_CALC: ''
ETA_UPDATED: ''
DISTANCE_TO_GO: '0'
DISTANCE_TRAVELLED: '54'
AVG_SPEED: '6.4'
MAX_SPEED: '6.8'
- MMSI: '229001000'
IMO: '7827213'
SHIP_ID: '1448'
LAT: '37.938670'
LON: '23.634450'
SPEED: '0'
HEADING: '511'
COURSE: '320'
STATUS: '5'
TIMESTAMP: '2020-10-15T12:17:20.000Z'
DSRC: TER
UTC_SECONDS: '20'
SHIPNAME: CELESTYAL CRYSTAL
SHIPTYPE: '36'
CALLSIGN: 9HA2978
FLAG: MT
LENGTH: '162'
WIDTH: '24'
GRT: '25611'
DWT: '1703'
DRAUGHT: '61'
YEAR_BUILT: '1980'
ROT: '0'
TYPE_NAME: Passenger Ship
AIS_TYPE_SUMMARY: Passenger
DESTINATION: PIRAEUS
ETA: '2021-03-14T05:40:00.000Z'
CURRENT_PORT: PIRAEUS
LAST_PORT: KUSADASI
LAST_PORT_TIME: '2020-03-13T17:38:00.000Z'
CURRENT_PORT_ID: '1'
CURRENT_PORT_UNLOCODE: GRPIR
CURRENT_PORT_COUNTRY: GR
LAST_PORT_ID: '17208'
LAST_PORT_UNLOCODE: TRKUS
LAST_PORT_COUNTRY: TR
NEXT_PORT_ID: '1'
NEXT_PORT_UNLOCODE: GRPIR
NEXT_PORT_NAME: PIRAEUS
NEXT_PORT_COUNTRY: GR
ETA_CALC: ''
ETA_UPDATED: ''
DISTANCE_TO_GO: '0'
DISTANCE_TRAVELLED: '194'
AVG_SPEED: '14.6'
MAX_SPEED: '16.7'
200_ps05_default:
title: Simple
type: array
items:
type: object
properties:
MMSI:
type: string
description: Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency
that identifies the vessel's transmitter station
IMO:
type: string
description: International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the subject vessel
LAT:
type: string
description: Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's
surface
LON:
type: string
description: Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's
surface
SPEED:
type: string
description: The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING:
type: string
description: The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE:
type: string
description: The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS:
type: string
description: The AIS Navigational Status of the subject vessel as input by the vessel's crew. There might be discrepancies
with the vessel's detail page when vessel speed is near zero (0) knots
TIMESTAMP:
type: string
description: The date and time (in UTC) that the subject vessel's position or event was recorded by MarineTraffic
format: date-time
DSRC:
type: string
description: Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite
AIS Station
UTC_SECONDS:
type: string
description: The time slot that the subject vessel uses to transmit information
example:
- MMSI: '538003913'
IMO: '9470959'
SHIP_ID: '713139'
LAT: '37.388430'
LON: '23.871230'
SPEED: '6'
HEADING: '104'
COURSE: '41'
STATUS: '0'
TIMESTAMP: '2020-10-15T12:21:44.000Z'
DSRC: TER
UTC_SECONDS: '45'
- MMSI: '239885200'
IMO: '0'
SHIP_ID: '3463456'
LAT: '37.390210'
LON: '24.396990'
SPEED: '1'
HEADING: '511'
COURSE: '0'
STATUS: '99'
TIMESTAMP: '2020-10-15T12:21:29.000Z'
DSRC: TER
UTC_SECONDS: '29'
200_ps05_extended:
title: Extended
type: array
items:
type: object
properties:
MMSI:
type: string
description: Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency
that identifies the vessel's transmitter station
IMO:
type: string
description: International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the subject vessel
LAT:
type: string
description: Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's
surface
LON:
type: string
description: Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's
surface
SPEED:
type: string
description: The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING:
type: string
description: The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE:
type: string
description: The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS:
type: string
description: The AIS Navigational Status of the subject vessel as input by the vessel's crew. There might be discrepancies
with the vessel's detail page when vessel speed is near zero (0) knots
TIMESTAMP:
type: string
description: The date and time (in UTC) that the subject vessel's position or event was recorded by MarineTraffic
format: date-time
DSRC:
type: string
description: Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite
AIS Station
UTC_SECONDS:
type: string
description: The time slot that the subject vessel uses to transmit information
SHIPNAME:
type: string
description: The Shipname of the subject vessel
SHIPTYPE:
type: string
description: The Shiptype of the subject vessel according to AIS transmissions
CALLSIGN:
type: string
description: A uniquely designated identifier for the vessel's transmitter station
FLAG:
type: string
description: The flag of the subject vessel according to AIS transmissions
LENGTH:
type: string
description: The overall Length (in metres) of the subject vessel
WIDTH:
type: string
description: The Breadth (in metres) of the subject vessel
GRT:
type: string
description: Gross Tonnage - unitless measure that calculates the moulded volume of all enclosed spaces of a ship
DWT:
type: string
description: Deadweight - a measure (in metric tons) of how much weight a vessel can safely carry (excluding the
vessel's own weight)
DRAUGHT:
type: string
description: The Draught (in metres x10) of the subject vessel according to the AIS transmissions
YEAR_BUILT:
type: string
description: The year that the subject vessel was built
ROT:
type: string
description: Rate of Turn
TYPE_NAME:
type: string
description: The Type of the subject vessel
AIS_TYPE_SUMMARY:
type: string
description: Further explanation of the SHIPTYPE ID
DESTINATION:
type: string
description: The Destination of the subject vessel according to the AIS transmissions
ETA:
type: string
description: The Estimated Time of Arrival to Destination of the subject vessel according to the AIS transmissions
format: date-time
example:
- MMSI: '538003913'
IMO: '9470959'
SHIP_ID: '713139'
LAT: '37.388430'
LON: '23.871230'
SPEED: '6'
HEADING: '104'
COURSE: '41'
STATUS: '0'
TIMESTAMP: '2020-10-15T12:21:44.000Z'
DSRC: TER
UTC_SECONDS: '45'
SHIPNAME: SUNNY STAR
SHIPTYPE: '89'
CALLSIGN: V7TZ6
FLAG: MH
LENGTH: '184'
WIDTH: '27.43'
GRT: '23313'
DWT: '37857'
DRAUGHT: '95'
YEAR_BUILT: '2010'
ROT: '0'
TYPE_NAME: Oil/Chemical Tanker
AIS_TYPE_SUMMARY: Tanker
DESTINATION: FOR ORDERS
ETA: '2020-10-14T12:00:00.000Z'
- MMSI: '239885200'
IMO: '0'
SHIP_ID: '3463456'
LAT: '37.390210'
LON: '24.396990'
SPEED: '1'
HEADING: '511'
COURSE: '0'
STATUS: '99'
TIMESTAMP: '2020-10-15T12:21:29.000Z'
DSRC: TER
UTC_SECONDS: '29'
SHIPNAME: ACHILLES
SHIPTYPE: '37'
CALLSIGN: SVA6160
FLAG: GR
LENGTH: '15'
WIDTH: '5'
GRT: ''
DWT: ''
DRAUGHT: '0'
YEAR_BUILT: ''
ROT: '0'
TYPE_NAME: Pleasure Craft
AIS_TYPE_SUMMARY: Pleasure Craft
DESTINATION: CLASS B
ETA: ''
200_ps05_full:
title: Full
type: array
items:
type: object
properties:
MMSI:
type: string
description: Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency
that identifies the vessel's transmitter station
IMO:
type: string
description: International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the subject vessel
LAT:
type: string
description: Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's
surface
LON:
type: string
description: Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's
surface
SPEED:
type: string
description: The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING:
type: string
description: The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE:
type: string
description: The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS:
type: string
description: The AIS Navigational Status of the subject vessel as input by the vessel's crew. There might be discrepancies
with the vessel's detail page when vessel speed is near zero (0) knots
TIMESTAMP:
type: string
description: The date and time (in UTC) that the subject vessel's position or event was recorded by MarineTraffic
format: date-time
DSRC:
type: string
description: Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite
AIS Station
UTC_SECONDS:
type: string
description: The time slot that the subject vessel uses to transmit information
SHIPNAME:
type: string
description: The Shipname of the subject vessel
SHIPTYPE:
type: string
description: The Shiptype of the subject vessel according to AIS transmissions
CALLSIGN:
type: string
description: A uniquely designated identifier for the vessel's transmitter station
FLAG:
type: string
description: The flag of the subject vessel according to AIS transmissions
LENGTH:
type: string
description: The overall Length (in metres) of the subject vessel
WIDTH:
type: string
description: The Breadth (in metres) of the subject vessel
GRT:
type: string
description: Gross Tonnage - unitless measure that calculates the moulded volume of all enclosed spaces of a ship
DWT:
type: string
description: Deadweight - a measure (in metric tons) of how much weight a vessel can safely carry (excluding the
vessel's own weight)
DRAUGHT:
type: string
description: The Draught (in metres x10) of the subject vessel according to the AIS transmissions
YEAR_BUILT:
type: string
description: The year that the subject vessel was built
ROT:
type: string
description: Rate of Turn
TYPE_NAME:
type: string
description: The Type of the subject vessel
AIS_TYPE_SUMMARY:
type: string
description: Further explanation of the SHIPTYPE ID
DESTINATION:
type: string
description: The Destination of the subject vessel according to the AIS transmissions
ETA:
type: string
description: The Estimated Time of Arrival to Destination of the subject vessel according to the AIS transmissions
format: date-time
CURRENT_PORT:
type: string
description: The name of the Port the subject vessel is currently in (NULL if the vessel is underway)
LAST_PORT:
type: string
description: The Name of the Last Port the vessel has visited
LAST_PORT_TIME:
type: string
description: The Date and Time (in UTC) that the subject vessel departed from the Last Port
format: date-time
CURRENT_PORT_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the Current Port
CURRENT_PORT_UNLOCODE:
type: string
description: A uniquely assigned ID by United Nations for the Current Port
CURRENT_PORT_COUNTRY:
type: string
description: The Country that the Current Port is located at
LAST_PORT_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the Last Port
LAST_PORT_UNLOCODE:
type: string
description: A uniquely assigned ID by United Nations for the Last Port
LAST_PORT_COUNTRY:
type: string
description: The Country that the Last Port is located at
NEXT_PORT_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the Next Port
NEXT_PORT_UNLOCODE:
type: string
description: A uniquely assigned ID by United Nations for the Next Port.
NEXT_PORT_NAME:
type: string
description: The Name of the Next Port as derived by MarineTraffic based on the subject vessel's reported Destination
NEXT_PORT_COUNTRY:
type: string
description: The Country that the Next Port is located at
ETA_CALC:
type: string
description: The Estimated Time of Arrival to Destination of the subject vessel according to the MarineTraffic
calculations
format: date-time
ETA_UPDATED:
type: string
description: The date and time (in UTC) that the ETA was calculated by MarineTraffic
format: date-time
DISTANCE_TO_GO:
type: string
description: The Remaining Distance (in NM) for the subject vessel to reach the reported Destination
DISTANCE_TRAVELLED:
type: string
description: The Distance (in NM) that the subject vessel has travelled since departing from Last Port
AVG_SPEED:
type: string
description: The average speed of the vessel (in knots) during the current voyage (since last port departure),
calculated using AIS position readings from the last 24 hours where speed exceeds 5 knots.
MAX_SPEED:
type: string
description: The maximum speed (in knots) recorded during the current voyage (since last port departure). This
value updates gradually and may lag behind the current speed following a sudden acceleration or shortly after
port departure.
example:
- MMSI: '538003913'
IMO: '9470959'
SHIP_ID: '713139'
LAT: '37.388430'
LON: '23.871230'
SPEED: '6'
HEADING: '104'
COURSE: '41'
STATUS: '0'
TIMESTAMP: '2020-10-15T12:21:44.000Z'
DSRC: TER
UTC_SECONDS: '45'
SHIPNAME: SUNNY STAR
SHIPTYPE: '89'
CALLSIGN: V7TZ6
FLAG: MH
LENGTH: '184'
WIDTH: '27.43'
GRT: '23313'
DWT: '37857'
DRAUGHT: '95'
YEAR_BUILT: '2010'
ROT: '0'
TYPE_NAME: Oil/Chemical Tanker
AIS_TYPE_SUMMARY: Tanker
DESTINATION: FOR ORDERS
ETA: '2020-10-14T12:00:00.000Z'
CURRENT_PORT: ''
LAST_PORT: AGIOI THEODOROI
LAST_PORT_TIME: '2020-10-13T23:39:00.000Z'
CURRENT_PORT_ID: ''
CURRENT_PORT_UNLOCODE: ''
CURRENT_PORT_COUNTRY: ''
LAST_PORT_ID: '29'
LAST_PORT_UNLOCODE: GRAGT
LAST_PORT_COUNTRY: GR
NEXT_PORT_ID: ''
NEXT_PORT_UNLOCODE: ''
NEXT_PORT_NAME: ''
NEXT_PORT_COUNTRY: ''
ETA_CALC: ''
ETA_UPDATED: ''
DISTANCE_TO_GO: '0'
DISTANCE_TRAVELLED: '74'
AVG_SPEED: '12.6'
MAX_SPEED: '13.2'
- MMSI: '239885200'
IMO: '0'
SHIP_ID: '3463456'
LAT: '37.390210'
LON: '24.396990'
SPEED: '1'
HEADING: '511'
COURSE: '0'
STATUS: '99'
TIMESTAMP: '2020-10-15T12:21:29.000Z'
DSRC: TER
UTC_SECONDS: '29'
SHIPNAME: ACHILLES
SHIPTYPE: '37'
CALLSIGN: SVA6160
FLAG: GR
LENGTH: '15'
WIDTH: '5'
GRT: ''
DWT: ''
DRAUGHT: '0'
YEAR_BUILT: ''
ROT: '0'
TYPE_NAME: Pleasure Craft
AIS_TYPE_SUMMARY: Pleasure Craft
DESTINATION: CLASS B
ETA: ''
CURRENT_PORT: KYTHNOS
LAST_PORT: SERIFOS
LAST_PORT_TIME: '2020-10-15T07:54:00.000Z'
CURRENT_PORT_ID: '19'
CURRENT_PORT_UNLOCODE: GRKYT
CURRENT_PORT_COUNTRY: GR
LAST_PORT_ID: '35'
LAST_PORT_UNLOCODE: GRSER
LAST_PORT_COUNTRY: GR
NEXT_PORT_ID: ''
NEXT_PORT_UNLOCODE: ''
NEXT_PORT_NAME: ''
NEXT_PORT_COUNTRY: ''
ETA_CALC: ''
ETA_UPDATED: ''
DISTANCE_TO_GO: '0'
DISTANCE_TRAVELLED: '22'
AVG_SPEED: '5.8'
MAX_SPEED: '6.4'
200_ps06_default:
title: Simple
type: array
items:
type: object
properties:
MMSI:
type: string
description: Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency
that identifies the vessel's transmitter station
IMO:
type: string
description: International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the subject vessel
LAT:
type: string
description: Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's
surface
LON:
type: string
description: Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's
surface
SPEED:
type: string
description: The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING:
type: string
description: The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE:
type: string
description: The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS:
type: string
description: The AIS Navigational Status of the subject vessel as input by the vessel's crew. There might be discrepancies
with the vessel's detail page when vessel speed is near zero (0) knots
TIMESTAMP:
type: string
description: The date and time (in UTC) that the subject vessel's position or event was recorded by MarineTraffic
format: date-time
DSRC:
type: string
description: Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite
AIS Station
UTC_SECONDS:
type: string
description: The time slot that the subject vessel uses to transmit information
example:
- MMSI: '538006210'
IMO: '9314105'
SHIP_ID: '475106'
LAT: '36.007480'
LON: '22.291650'
SPEED: '4'
HEADING: '273'
COURSE: '49'
STATUS: '0'
TIMESTAMP: '2020-10-15T12:26:10.000Z'
DSRC: TER
UTC_SECONDS: '7'
- MMSI: '355281000'
IMO: '9590826'
SHIP_ID: '416371'
LAT: '36.008020'
LON: '22.596420'
SPEED: '144'
HEADING: '95'
COURSE: '94'
STATUS: '0'
TIMESTAMP: '2020-10-15T12:26:02.000Z'
DSRC: TER
UTC_SECONDS: '59'
200_ps06_extended:
title: Extended
type: array
items:
type: object
properties:
MMSI:
type: string
description: Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency
that identifies the vessel's transmitter station
IMO:
type: string
description: International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the subject vessel
LAT:
type: string
description: Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's
surface
LON:
type: string
description: Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's
surface
SPEED:
type: string
description: The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING:
type: string
description: The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE:
type: string
description: The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS:
type: string
description: The AIS Navigational Status of the subject vessel as input by the vessel's crew. There might be discrepancies
with the vessel's detail page when vessel speed is near zero (0) knots
TIMESTAMP:
type: string
description: The date and time (in UTC) that the subject vessel's position or event was recorded by MarineTraffic
format: date-time
DSRC:
type: string
description: Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite
AIS Station
UTC_SECONDS:
type: string
description: The time slot that the subject vessel uses to transmit information
SHIPNAME:
type: string
description: The Shipname of the subject vessel
SHIPTYPE:
type: string
description: The Shiptype of the subject vessel according to AIS transmissions
CALLSIGN:
type: string
description: A uniquely designated identifier for the vessel's transmitter station
FLAG:
type: string
description: The flag of the subject vessel according to AIS transmissions
LENGTH:
type: string
description: The overall Length (in metres) of the subject vessel
WIDTH:
type: string
description: The Breadth (in metres) of the subject vessel
GRT:
type: string
description: Gross Tonnage - unitless measure that calculates the moulded volume of all enclosed spaces of a ship
DWT:
type: string
description: Deadweight - a measure (in metric tons) of how much weight a vessel can safely carry (excluding the
vessel's own weight)
DRAUGHT:
type: string
description: The Draught (in metres x10) of the subject vessel according to the AIS transmissions
YEAR_BUILT:
type: string
description: The year that the subject vessel was built
ROT:
type: string
description: Rate of Turn
TYPE_NAME:
type: string
description: The Type of the subject vessel
AIS_TYPE_SUMMARY:
type: string
description: Further explanation of the SHIPTYPE ID
DESTINATION:
type: string
description: The Destination of the subject vessel according to the AIS transmissions
ETA:
type: string
description: The Estimated Time of Arrival to Destination of the subject vessel according to the AIS transmissions
format: date-time
example:
- MMSI: '249046000'
IMO: '9192399'
SHIP_ID: '287622'
LAT: '37.023900'
LON: '23.123580'
SPEED: '6'
HEADING: '25'
COURSE: '304'
STATUS: '0'
TIMESTAMP: '2020-10-15T12:23:22.000Z'
DSRC: TER
UTC_SECONDS: '19'
SHIPNAME: CELEBRITY CONSTELLATION
SHIPTYPE: '60'
CALLSIGN: 9HJB9
FLAG: MT
LENGTH: '294'
WIDTH: '37.4'
GRT: '90940'
DWT: '11763'
DRAUGHT: '83'
YEAR_BUILT: '2002'
ROT: '0'
TYPE_NAME: Passenger Ship
AIS_TYPE_SUMMARY: Passenger
DESTINATION: PIRAEUS ANCHORAGE
ETA: '2020-10-26T06:00:00.000Z'
- MMSI: '271000973'
IMO: '9458250'
SHIP_ID: '335299'
LAT: '37.156790'
LON: '23.799120'
SPEED: '116'
HEADING: '212'
COURSE: '212'
STATUS: '0'
TIMESTAMP: '2020-10-15T12:22:35.000Z'
DSRC: TER
UTC_SECONDS: '35'
SHIPNAME: ULUSOY 8
SHIPTYPE: '70'
CALLSIGN: TCSS9
FLAG: TR
LENGTH: '159.9'
WIDTH: '24'
GRT: '14852'
DWT: '22303'
DRAUGHT: '99'
YEAR_BUILT: '2008'
ROT: '0'
TYPE_NAME: Bulk Carrier
AIS_TYPE_SUMMARY: Cargo
DESTINATION: GI GIB
ETA: '2020-10-20T17:00:00.000Z'
200_ps06_full:
title: Full
type: array
items:
type: object
properties:
MMSI:
type: string
description: Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency
that identifies the vessel's transmitter station
IMO:
type: string
description: International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the subject vessel
LAT:
type: string
description: Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's
surface
LON:
type: string
description: Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's
surface
SPEED:
type: string
description: The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING:
type: string
description: The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE:
type: string
description: The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS:
type: string
description: The AIS Navigational Status of the subject vessel as input by the vessel's crew. There might be discrepancies
with the vessel's detail page when vessel speed is near zero (0) knots
TIMESTAMP:
type: string
description: The date and time (in UTC) that the subject vessel's position or event was recorded by MarineTraffic
format: date-time
DSRC:
type: string
description: Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite
AIS Station
UTC_SECONDS:
type: string
description: The time slot that the subject vessel uses to transmit information
SHIPNAME:
type: string
description: The Shipname of the subject vessel
SHIPTYPE:
type: string
description: The Shiptype of the subject vessel according to AIS transmissions
CALLSIGN:
type: string
description: A uniquely designated identifier for the vessel's transmitter station
FLAG:
type: string
description: The flag of the subject vessel according to AIS transmissions
LENGTH:
type: string
description: The overall Length (in metres) of the subject vessel
WIDTH:
type: string
description: The Breadth (in metres) of the subject vessel
GRT:
type: string
description: Gross Tonnage - unitless measure that calculates the moulded volume of all enclosed spaces of a ship
DWT:
type: string
description: Deadweight - a measure (in metric tons) of how much weight a vessel can safely carry (excluding the
vessel's own weight)
DRAUGHT:
type: string
description: The Draught (in metres x10) of the subject vessel according to the AIS transmissions
YEAR_BUILT:
type: string
description: The year that the subject vessel was built
ROT:
type: string
description: Rate of Turn
TYPE_NAME:
type: string
description: The Type of the subject vessel
AIS_TYPE_SUMMARY:
type: string
description: Further explanation of the SHIPTYPE ID
DESTINATION:
type: string
description: The Destination of the subject vessel according to the AIS transmissions
ETA:
type: string
description: The Estimated Time of Arrival to Destination of the subject vessel according to the AIS transmissions
format: date-time
CURRENT_PORT:
type: string
description: The name of the Port the subject vessel is currently in (NULL if the vessel is underway)
LAST_PORT:
type: string
description: The Name of the Last Port the vessel has visited
LAST_PORT_TIME:
type: string
description: The Date and Time (in UTC) that the subject vessel departed from the Last Port
format: date-time
CURRENT_PORT_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the Current Port
CURRENT_PORT_UNLOCODE:
type: string
description: A uniquely assigned ID by United Nations for the Current Port
CURRENT_PORT_COUNTRY:
type: string
description: The Country that the Current Port is located at
LAST_PORT_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the Last Port
LAST_PORT_UNLOCODE:
type: string
description: A uniquely assigned ID by United Nations for the Last Port
LAST_PORT_COUNTRY:
type: string
description: The Country that the Last Port is located at
NEXT_PORT_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the Next Port
NEXT_PORT_UNLOCODE:
type: string
description: A uniquely assigned ID by United Nations for the Next Port.
NEXT_PORT_NAME:
type: string
description: The Name of the Next Port as derived by MarineTraffic based on the subject vessel's reported Destination
NEXT_PORT_COUNTRY:
type: string
description: The Country that the Next Port is located at
ETA_CALC:
type: string
description: The Estimated Time of Arrival to Destination of the subject vessel according to the MarineTraffic
calculations
format: date-time
ETA_UPDATED:
type: string
description: The date and time (in UTC) that the ETA was calculated by MarineTraffic
format: date-time
DISTANCE_TO_GO:
type: string
description: The Remaining Distance (in NM) for the subject vessel to reach the reported Destination
DISTANCE_TRAVELLED:
type: string
description: The Distance (in NM) that the subject vessel has travelled since departing from Last Port
AVG_SPEED:
type: string
description: The average speed of the vessel (in knots) during the current voyage (since last port departure),
calculated using AIS position readings from the last 24 hours where speed exceeds 5 knots.
MAX_SPEED:
type: string
description: The maximum speed (in knots) recorded during the current voyage (since last port departure). This
value updates gradually and may lag behind the current speed following a sudden acceleration or shortly after
port departure.
example:
- MMSI: '249046000'
IMO: '9192399'
SHIP_ID: '287622'
LAT: '37.023900'
LON: '23.123580'
SPEED: '6'
HEADING: '25'
COURSE: '304'
STATUS: '0'
TIMESTAMP: '2020-10-15T12:23:22.000Z'
DSRC: TER
UTC_SECONDS: '19'
SHIPNAME: CELEBRITY CONSTELLATION
SHIPTYPE: '60'
CALLSIGN: 9HJB9
FLAG: MT
LENGTH: '294'
WIDTH: '37.4'
GRT: '90940'
DWT: '11763'
DRAUGHT: '83'
YEAR_BUILT: '2002'
ROT: '0'
TYPE_NAME: Passenger Ship
AIS_TYPE_SUMMARY: Passenger
DESTINATION: PIRAEUS ANCHORAGE
ETA: '2020-10-26T06:00:00.000Z'
CURRENT_PORT: ''
LAST_PORT: PIRAEUS
LAST_PORT_TIME: '2020-07-31T08:56:00.000Z'
CURRENT_PORT_ID: ''
CURRENT_PORT_UNLOCODE: ''
CURRENT_PORT_COUNTRY: ''
LAST_PORT_ID: '1'
LAST_PORT_UNLOCODE: GRPIR
LAST_PORT_COUNTRY: GR
NEXT_PORT_ID: '1'
NEXT_PORT_UNLOCODE: GRPIR
NEXT_PORT_NAME: PIRAEUS
NEXT_PORT_COUNTRY: GR
ETA_CALC: '2020-10-14T17:00:00.000Z'
ETA_UPDATED: '2020-10-14T05:59:00.000Z'
DISTANCE_TO_GO: '0'
DISTANCE_TRAVELLED: '3156'
AVG_SPEED: '6'
MAX_SPEED: '6.7'
- MMSI: '271000973'
IMO: '9458250'
SHIP_ID: '335299'
LAT: '37.156790'
LON: '23.799120'
SPEED: '116'
HEADING: '212'
COURSE: '212'
STATUS: '0'
TIMESTAMP: '2020-10-15T12:22:35.000Z'
DSRC: TER
UTC_SECONDS: '35'
SHIPNAME: ULUSOY 8
SHIPTYPE: '70'
CALLSIGN: TCSS9
FLAG: TR
LENGTH: '159.9'
WIDTH: '24'
GRT: '14852'
DWT: '22303'
DRAUGHT: '99'
YEAR_BUILT: '2008'
ROT: '0'
TYPE_NAME: Bulk Carrier
AIS_TYPE_SUMMARY: Cargo
DESTINATION: GI GIB
ETA: '2020-10-20T17:00:00.000Z'
CURRENT_PORT: ''
LAST_PORT: ODESSA
LAST_PORT_TIME: '2020-10-12T05:24:00.000Z'
CURRENT_PORT_ID: ''
CURRENT_PORT_UNLOCODE: ''
CURRENT_PORT_COUNTRY: ''
LAST_PORT_ID: '124'
LAST_PORT_UNLOCODE: UAODS
LAST_PORT_COUNTRY: UA
NEXT_PORT_ID: '186'
NEXT_PORT_UNLOCODE: GIGIB
NEXT_PORT_NAME: GIBRALTAR
NEXT_PORT_COUNTRY: GI
ETA_CALC: '2020-10-21T00:39:00.000Z'
ETA_UPDATED: '2020-10-15T12:02:00.000Z'
DISTANCE_TO_GO: '1454'
DISTANCE_TRAVELLED: '704'
AVG_SPEED: '11.3'
MAX_SPEED: '13'
200_ps07_default:
title: Simple
type: array
items:
type: object
properties:
MMSI:
type: string
description: Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency
that identifies the vessel's transmitter station
LAT:
type: string
description: Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's
surface
LON:
type: string
description: Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's
surface
SPEED:
type: string
description: The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING:
type: string
description: The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE:
type: string
description: The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS:
type: string
description: The AIS Navigational Status of the subject vessel as input by the vessel's crew. There might be discrepancies
with the vessel's detail page when vessel speed is near zero (0) knots
TIMESTAMP:
type: string
description: The date and time (in UTC) that the subject vessel's position or event was recorded by MarineTraffic
format: date-time
DSRC:
type: string
description: Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite
AIS Station
example:
- MMSI: '310627000'
LAT: '50.510560'
LON: '-3.452753'
SPEED: '0'
HEADING: '347'
COURSE: '321'
STATUS: '1'
TIMESTAMP: '2020-10-13T12:21:16.000Z'
DSRC: TER
200_ps07_extended:
title: Extended
type: array
items:
type: object
properties:
MMSI:
type: string
description: Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency
that identifies the vessel's transmitter station
LAT:
type: string
description: Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's
surface
LON:
type: string
description: Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's
surface
SPEED:
type: string
description: The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING:
type: string
description: The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE:
type: string
description: The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS:
type: string
description: The AIS Navigational Status of the subject vessel as input by the vessel's crew. There might be discrepancies
with the vessel's detail page when vessel speed is near zero (0) knots
TIMESTAMP:
type: string
description: The date and time (in UTC) that the subject vessel's position or event was recorded by MarineTraffic
format: date-time
DSRC:
type: string
description: Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite
AIS Station
SHIPNAME:
type: string
description: The Shipname of the subject vessel
SHIPTYPE:
type: string
description: The Shiptype of the subject vessel according to AIS transmissions
IMO:
type: string
description: International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
CALLSIGN:
type: string
description: A uniquely designated identifier for the vessel's transmitter station
FLAG:
type: string
description: The flag of the subject vessel according to AIS transmissions
CURRENT_PORT:
type: string
description: The name of the Port the subject vessel is currently in (NULL if the vessel is underway)
LAST_PORT:
type: string
description: The Name of the Last Port the vessel has visited
LAST_PORT_TIME:
type: string
description: The Date and Time (in UTC) that the subject vessel departed from the Last Port
format: date-time
DESTINATION:
type: string
description: The Destination of the subject vessel according to the AIS transmissions
LENGTH:
type: string
description: The overall Length (in metres) of the subject vessel
WIDTH:
type: string
description: The Breadth (in metres) of the subject vessel
DRAUGHT:
type: string
description: The Draught (in metres x10) of the subject vessel according to the AIS transmissions
GRT:
type: string
description: Gross Tonnage - unitless measure that calculates the moulded volume of all enclosed spaces of a ship
DWT:
type: string
description: Deadweight - a measure (in metric tons) of how much weight a vessel can safely carry (excluding the
vessel's own weight)
YEAR_BUILT:
type: string
description: The year that the subject vessel was built
PORT_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the Current Port
PORT_UNLOCODE:
type: string
description: A uniquely assigned ID by United Nations for the Current Port
LAST_PORT_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the Last Port
LAST_PORT_UNLOCODE:
type: string
description: A uniquely assigned ID by United Nations for the Last Port
ETA:
type: string
description: The Estimated Time of Arrival to Destination of the subject vessel according to the AIS transmissions
format: date-time
ETA_CALC:
type: string
description: The Estimated Time of Arrival to Destination of the subject vessel according to the MarineTraffic
calculations
format: date-time
NEXT_PORT_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the Next Port
NEXT_PORT_UNLOCODE:
type: string
description: A uniquely assigned ID by United Nations for the Next Port
NEXT_PORT_NAME:
type: string
description: The Name of the Next Port as derived by MarineTraffic based on the subject vessel's reported Destination
NEXT_PORT_COUNTRY:
type: string
description: The Country that the Next Port is located at
TYPE_NAME:
type: string
description: The Type of the subject vessel
AIS_TYPE_SUMMARY:
type: string
description: Further explanation of the SHIPTYPE ID
example:
- MMSI: '310627000'
LAT: '-35.564580'
LON: '126.044800'
SPEED: '226'
HEADING: '89'
COURSE: '89'
STATUS: '0'
TIMESTAMP: '2017-02-14T16:14:00.000Z'
SHIPNAME: QUEEN MARY 2
SHIPTYPE: '60'
TYPE_NAME: Passengers Ship
AIS_TYPE_SUMMARY: Passenger
IMO: '9241061'
CALLSIGN: ZCEF6
FLAG: BM
PORT_ID: null
PORT_UNLOCODE: null
CURRENT_PORT: null
LAST_PORT_ID: '768'
LAST_PORT_UNLOCODE: AUFRE
LAST_PORT: FREMANTLE
LAST_PORT_TIME: '2017-02-12T12:47:00.000Z'
DESTINATION: ADELAIDE
ETA: '2017-02-15T23:00:00.000Z'
ETA_CALC: '2017-02-15T21:30:00.000Z'
LENGTH: '345.03'
WIDTH: '48.7'
DRAUGHT: '101'
GRT: '149215'
NEXT_PORT_ID: '890'
NEXT_PORT_UNLOCODE: AUADL
NEXT_PORT_NAME: ADELAIDE
NEXT_PORT_COUNTRY: AU
DWT: '19189'
YEAR_BUILT: '2003'
DSRC: SAT
400_ps07__missing_ship_identifier:
title: ' Missing ship identifier'
type: object
properties:
errors:
type: array
items:
type: object
properties:
code:
type: string
description: Error code
detail:
type: string
description: Error message
example:
errors:
- code: '2'
detail: VESSEL MMSI OR IMO OR SHIPID MISSING
200_ps08_default:
title: Simple
type: array
items:
type: object
properties:
MMSI:
type: string
description: Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency
that identifies the vessel's transmitter station
IMO:
type: string
description: International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the subject vessel
LAT:
type: string
description: Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's
surface
LON:
type: string
description: Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's
surface
SPEED:
type: string
description: The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING:
type: string
description: The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE:
type: string
description: The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS:
type: string
description: The AIS Navigational Status of the subject vessel as input by the vessel's crew. There might be discrepancies
with the vessel's detail page when vessel speed is near zero (0) knots
TIMESTAMP:
type: string
description: The date and time (in UTC) that the subject vessel's position or event was recorded by MarineTraffic
format: date-time
DSRC:
type: string
description: Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite
AIS Station
UTC_SECONDS:
type: string
description: The time slot that the subject vessel uses to transmit information
example:
- MMSI: '538003913'
IMO: '9470959'
SHIP_ID: '713139'
LAT: '37.388430'
LON: '23.871230'
SPEED: '6'
HEADING: '104'
COURSE: '41'
STATUS: '0'
TIMESTAMP: '2020-10-15T12:21:44.000Z'
DSRC: TER
UTC_SECONDS: '45'
- MMSI: '239885200'
IMO: '0'
SHIP_ID: '3463456'
LAT: '37.390210'
LON: '24.396990'
SPEED: '1'
HEADING: '511'
COURSE: '0'
STATUS: '99'
TIMESTAMP: '2020-10-15T12:21:29.000Z'
DSRC: TER
UTC_SECONDS: '29'
200_ps08_extended:
title: Extended
type: array
items:
type: object
properties:
MMSI:
type: string
description: Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency
that identifies the vessel's transmitter station
IMO:
type: string
description: International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the subject vessel
LAT:
type: string
description: Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's
surface
LON:
type: string
description: Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's
surface
SPEED:
type: string
description: The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING:
type: string
description: The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE:
type: string
description: The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS:
type: string
description: The AIS Navigational Status of the subject vessel as input by the vessel's crew. There might be discrepancies
with the vessel's detail page when vessel speed is near zero (0) knots
TIMESTAMP:
type: string
description: The date and time (in UTC) that the subject vessel's position or event was recorded by MarineTraffic
format: date-time
DSRC:
type: string
description: Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite
AIS Station
UTC_SECONDS:
type: string
description: The time slot that the subject vessel uses to transmit information
SHIPNAME:
type: string
description: The Shipname of the subject vessel
SHIPTYPE:
type: string
description: The Shiptype of the subject vessel according to AIS transmissions
CALLSIGN:
type: string
description: A uniquely designated identifier for the vessel's transmitter station
FLAG:
type: string
description: The flag of the subject vessel according to AIS transmissions
LENGTH:
type: string
description: The overall Length (in metres) of the subject vessel
WIDTH:
type: string
description: The Breadth (in metres) of the subject vessel
GRT:
type: string
description: Gross Tonnage - unitless measure that calculates the moulded volume of all enclosed spaces of a ship
DWT:
type: string
description: Deadweight - a measure (in metric tons) of how much weight a vessel can safely carry (excluding the
vessel's own weight)
DRAUGHT:
type: string
description: The Draught (in metres x10) of the subject vessel according to the AIS transmissions
YEAR_BUILT:
type: string
description: The year that the subject vessel was built
ROT:
type: string
description: Rate of Turn
TYPE_NAME:
type: string
description: The Type of the subject vessel
AIS_TYPE_SUMMARY:
type: string
description: Further explanation of the SHIPTYPE ID
DESTINATION:
type: string
description: The Destination of the subject vessel according to the AIS transmissions
ETA:
type: string
description: The Estimated Time of Arrival to Destination of the subject vessel according to the AIS transmissions
format: date-time
example:
- MMSI: '538003913'
IMO: '9470959'
SHIP_ID: '713139'
LAT: '37.388430'
LON: '23.871230'
SPEED: '6'
HEADING: '104'
COURSE: '41'
STATUS: '0'
TIMESTAMP: '2020-10-15T12:21:44.000Z'
DSRC: TER
UTC_SECONDS: '45'
SHIPNAME: SUNNY STAR
SHIPTYPE: '89'
CALLSIGN: V7TZ6
FLAG: MH
LENGTH: '184'
WIDTH: '27.43'
GRT: '23313'
DWT: '37857'
DRAUGHT: '95'
YEAR_BUILT: '2010'
ROT: '0'
TYPE_NAME: Oil/Chemical Tanker
AIS_TYPE_SUMMARY: Tanker
DESTINATION: FOR ORDERS
ETA: '2020-10-14T12:00:00.000Z'
- MMSI: '239885200'
IMO: '0'
SHIP_ID: '3463456'
LAT: '37.390210'
LON: '24.396990'
SPEED: '1'
HEADING: '511'
COURSE: '0'
STATUS: '99'
TIMESTAMP: '2020-10-15T12:21:29.000Z'
DSRC: TER
UTC_SECONDS: '29'
SHIPNAME: ACHILLES
SHIPTYPE: '37'
CALLSIGN: SVA6160
FLAG: GR
LENGTH: '15'
WIDTH: '5'
GRT: ''
DWT: ''
DRAUGHT: '0'
YEAR_BUILT: ''
ROT: '0'
TYPE_NAME: Pleasure Craft
AIS_TYPE_SUMMARY: Pleasure Craft
DESTINATION: CLASS B
ETA: ''
200_ps08_full:
title: Full
type: array
items:
type: object
properties:
MMSI:
type: string
description: Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency
that identifies the vessel's transmitter station
IMO:
type: string
description: International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the subject vessel
LAT:
type: string
description: Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's
surface
LON:
type: string
description: Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's
surface
SPEED:
type: string
description: The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING:
type: string
description: The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE:
type: string
description: The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS:
type: string
description: The AIS Navigational Status of the subject vessel as input by the vessel's crew. There might be discrepancies
with the vessel's detail page when vessel speed is near zero (0) knots
TIMESTAMP:
type: string
description: The date and time (in UTC) that the subject vessel's position or event was recorded by MarineTraffic
format: date-time
DSRC:
type: string
description: Data Source - Defines whether the transmitted AIS data was received by a Terrestrial or a Satellite
AIS Station
UTC_SECONDS:
type: string
description: The time slot that the subject vessel uses to transmit information
SHIPNAME:
type: string
description: The Shipname of the subject vessel
SHIPTYPE:
type: string
description: The Shiptype of the subject vessel according to AIS transmissions
CALLSIGN:
type: string
description: A uniquely designated identifier for the vessel's transmitter station
FLAG:
type: string
description: The flag of the subject vessel according to AIS transmissions
LENGTH:
type: string
description: The overall Length (in metres) of the subject vessel
WIDTH:
type: string
description: The Breadth (in metres) of the subject vessel
GRT:
type: string
description: Gross Tonnage - unitless measure that calculates the moulded volume of all enclosed spaces of a ship
DWT:
type: string
description: Deadweight - a measure (in metric tons) of how much weight a vessel can safely carry (excluding the
vessel's own weight)
DRAUGHT:
type: string
description: The Draught (in metres x10) of the subject vessel according to the AIS transmissions
YEAR_BUILT:
type: string
description: The year that the subject vessel was built
ROT:
type: string
description: Rate of Turn
TYPE_NAME:
type: string
description: The Type of the subject vessel
AIS_TYPE_SUMMARY:
type: string
description: Further explanation of the SHIPTYPE ID
DESTINATION:
type: string
description: The Destination of the subject vessel according to the AIS transmissions
ETA:
type: string
description: The Estimated Time of Arrival to Destination of the subject vessel according to the AIS transmissions
format: date-time
CURRENT_PORT:
type: string
description: The name of the Port the subject vessel is currently in (NULL if the vessel is underway)
LAST_PORT:
type: string
description: The Name of the Last Port the vessel has visited
LAST_PORT_TIME:
type: string
description: The Date and Time (in UTC) that the subject vessel departed from the Last Port
format: date-time
CURRENT_PORT_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the Current Port
CURRENT_PORT_UNLOCODE:
type: string
description: A uniquely assigned ID by United Nations for the Current Port
CURRENT_PORT_COUNTRY:
type: string
description: The Country that the Current Port is located at
LAST_PORT_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the Last Port
LAST_PORT_UNLOCODE:
type: string
description: A uniquely assigned ID by United Nations for the Last Port
LAST_PORT_COUNTRY:
type: string
description: The Country that the Last Port is located at
NEXT_PORT_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the Next Port
NEXT_PORT_UNLOCODE:
type: string
description: A uniquely assigned ID by United Nations for the Next Port
NEXT_PORT_NAME:
type: string
description: The Name of the Next Port as derived by MarineTraffic based on the subject vessel's reported Destination
NEXT_PORT_COUNTRY:
type: string
description: The Country that the Next Port is located at
ETA_CALC:
type: string
description: The Estimated Time of Arrival to Destination of the subject vessel according to the MarineTraffic
calculations
format: date-time
ETA_UPDATED:
type: string
description: The date and time (in UTC) that the ETA was calculated by MarineTraffic
format: date-time
DISTANCE_TO_GO:
type: string
description: The Remaining Distance (in NM) for the subject vessel to reach the reported Destination
DISTANCE_TRAVELLED:
type: string
description: The Distance (in NM) that the subject vessel has travelled since departing from Last Port
AVG_SPEED:
type: string
description: The average speed of the vessel (in knots) during the current voyage (since last port departure),
calculated using AIS position readings from the last 24 hours where speed exceeds 5 knots.
MAX_SPEED:
type: string
description: The maximum speed (in knots) recorded during the current voyage (since last port departure). This
value updates gradually and may lag behind the current speed following a sudden acceleration or shortly after
port departure.
example:
- MMSI: '538003913'
IMO: '9470959'
SHIP_ID: '713139'
LAT: '37.388430'
LON: '23.871230'
SPEED: '6'
HEADING: '104'
COURSE: '41'
STATUS: '0'
TIMESTAMP: '2020-10-15T12:21:44.000Z'
DSRC: TER
UTC_SECONDS: '45'
SHIPNAME: SUNNY STAR
SHIPTYPE: '89'
CALLSIGN: V7TZ6
FLAG: MH
LENGTH: '184'
WIDTH: '27.43'
GRT: '23313'
DWT: '37857'
DRAUGHT: '95'
YEAR_BUILT: '2010'
ROT: '0'
TYPE_NAME: Oil/Chemical Tanker
AIS_TYPE_SUMMARY: Tanker
DESTINATION: FOR ORDERS
ETA: '2020-10-14T12:00:00.000Z'
CURRENT_PORT: ''
LAST_PORT: AGIOI THEODOROI
LAST_PORT_TIME: '2020-10-13T23:39:00.000Z'
CURRENT_PORT_ID: ''
CURRENT_PORT_UNLOCODE: ''
CURRENT_PORT_COUNTRY: ''
LAST_PORT_ID: '29'
LAST_PORT_UNLOCODE: GRAGT
LAST_PORT_COUNTRY: GR
NEXT_PORT_ID: ''
NEXT_PORT_UNLOCODE: ''
NEXT_PORT_NAME: ''
NEXT_PORT_COUNTRY: ''
ETA_CALC: ''
ETA_UPDATED: ''
DISTANCE_TO_GO: '0'
DISTANCE_TRAVELLED: '74'
AVG_SPEED: '12.6'
MAX_SPEED: '13.2'
- MMSI: '239885200'
IMO: '0'
SHIP_ID: '3463456'
LAT: '37.390210'
LON: '24.396990'
SPEED: '1'
HEADING: '511'
COURSE: '0'
STATUS: '99'
TIMESTAMP: '2020-10-15T12:21:29.000Z'
DSRC: TER
UTC_SECONDS: '29'
SHIPNAME: ACHILLES
SHIPTYPE: '37'
CALLSIGN: SVA6160
FLAG: GR
LENGTH: '15'
WIDTH: '5'
GRT: ''
DWT: ''
DRAUGHT: '0'
YEAR_BUILT: ''
ROT: '0'
TYPE_NAME: Pleasure Craft
AIS_TYPE_SUMMARY: Pleasure Craft
DESTINATION: CLASS B
ETA: ''
CURRENT_PORT: KYTHNOS
LAST_PORT: SERIFOS
LAST_PORT_TIME: '2020-10-15T07:54:00.000Z'
CURRENT_PORT_ID: '19'
CURRENT_PORT_UNLOCODE: GRKYT
CURRENT_PORT_COUNTRY: GR
LAST_PORT_ID: '35'
LAST_PORT_UNLOCODE: GRSER
LAST_PORT_COUNTRY: GR
NEXT_PORT_ID: ''
NEXT_PORT_UNLOCODE: ''
NEXT_PORT_NAME: ''
NEXT_PORT_COUNTRY: ''
ETA_CALC: ''
ETA_UPDATED: ''
DISTANCE_TO_GO: '0'
DISTANCE_TRAVELLED: '22'
AVG_SPEED: '5.8'
MAX_SPEED: '6.4'
200_MTA030AD:
title: Default
type: object
properties:
DATA:
type: array
items:
type: object
properties:
MMSI:
type: string
description: Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency
that identifies the vessel's transmitter station
IMO:
type: string
description: International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the subject vessel
LAT:
type: string
description: Latitude - a geographic coordinate that specifies the north-south position of the vessel on the
Earth's surface
LON:
type: string
description: Longitude - a geographic coordinate that specifies the east-west position of the vessel on the
Earth's surface
SPEED:
type: string
description: The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING:
type: string
description: The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE:
type: string
description: The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS:
type: string
description: The AIS Navigational Status of the subject vessel as input by the vessel's crew. There might
be discrepancies with the vessel's detail page when vessel speed is near zero (0) knots
TIMESTAMP:
type: string
description: The date and time (in UTC) that the subject vessel's position or event was recorded by MarineTraffic
format: date-time
DSRC:
type: string
description: Describes whether the transmitted AIS message was received by a terrestrial (TER), satellite
(SAT) or roaming (ROAM) AIS antenna.
UTC_SECONDS:
type: string
description: The time slot that the subject vessel uses to transmit information
MARKET:
type: string
description: Vessel's commercial market
SHIPNAME:
type: string
description: The Shipname of the subject vessel
SHIPTYPE:
type: string
description: The Shiptype of the subject vessel according to AIS transmissions
CALLSIGN:
type: string
description: A uniquely designated identifier for the vessel's transmitter station
FLAG:
type: string
description: The flag of the subject vessel according to AIS transmissions
LENGTH:
type: string
description: The overall Length (in metres) of the subject vessel
WIDTH:
type: string
description: The Breadth (in metres) of the subject vessel
GRT:
type: string
description: Gross Tonnage - unitless measure that calculates the moulded volume of all enclosed spaces of
a ship
DWT:
type: string
description: Deadweight - a measure (in metric tons) of how much weight a vessel can safely carry (excluding
the vessel's own weight)
DRAUGHT:
type: string
description: The Draught (in metres x10) of the subject vessel according to the AIS transmissions
YEAR_BUILT:
type: string
description: The year that the subject vessel was built
SHIP_COUNTRY:
type: string
description: The vessel's country
SHIP_CLASS:
type: string
description: Vessel's class based on commercial market, capacity and/or dimensions
ROT:
type: string
description: Rate of Turn
TYPE_NAME:
type: string
description: The MarineTraffic ship type of the vessel
AIS_TYPE_SUMMARY:
type: string
description: Further explanation of the SHIPTYPE ID
DESTINATION:
type: string
description: The Destination of the subject vessel according to the AIS transmissions
ETA:
type: string
description: The Estimated Time of Arrival to Destination of the subject vessel according to the AIS transmissions
format: date-time
L_FORE:
type: string
description: The relative distance from the AIS station of the vessel to the foremost of it (front / bow)
W_LEFT:
type: string
description: The relative distance from the AIS station of the vessel to the leftmost of it (left side / port)
LAST_PORT:
type: string
description: The Name of the Last Port the vessel has visited
LAST_PORT_TIME:
type: string
description: The Date and Time (in UTC) that the subject vessel departed from the Last Port
format: date-time
LAST_PORT_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the Last Port
LAST_PORT_UNLOCODE:
type: string
description: A uniquely assigned ID by United Nations for the Last Port
LAST_PORT_COUNTRY:
type: string
description: The Country that the Last Port is located at
CURRENT_PORT:
type: string
description: The name of the Port the subject vessel is currently in (NULL if the vessel is underway)
CURRENT_PORT_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the Current Port
CURRENT_PORT_UNLOCODE:
type: string
description: A uniquely assigned ID by United Nations for the Current Port
CURRENT_PORT_COUNTRY:
type: string
description: The Country that the Current Port is located at
NEXT_PORT_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the Next Port
NEXT_PORT_UNLOCODE:
type: string
description: A uniquely assigned ID by United Nations for the Next Port
NEXT_PORT_NAME:
type: string
description: The Name of the Next Port as derived by MarineTraffic based on the subject vessel's reported
Destination
NEXT_PORT_COUNTRY:
type: string
description: The Country that the Next Port is located at
ETA_CALC:
type: string
description: The Estimated Time of Arrival to Destination of the subject vessel according to the MarineTraffic
calculations
format: date-time
ETA_UPDATED:
type: string
description: The date and time (in UTC) that the ETA was calculated by MarineTraffic
format: date-time
DISTANCE_TO_GO:
type: string
description: The Remaining Distance (in NM) for the subject vessel to reach the reported Destination
DISTANCE_TRAVELLED:
type: string
description: The Distance (in NM) that the subject vessel has travelled since departing from Last Port
AVG_SPEED:
type: string
description: The average speed of the vessel (in knots) during the current voyage (since last port departure),
calculated using AIS position readings from the last 24 hours where speed exceeds 5 knots.
MAX_SPEED:
type: string
description: The maximum speed (in knots) recorded during the current voyage (since last port departure).
This value updates gradually and may lag behind the current speed following a sudden acceleration or shortly
after port departure.
METADATA:
type: object
properties:
CURSOR:
type: string
description: The pagination cursor that should be provided in the next request
DATE_FROM:
type: string
description: The starting date of the returned positions
format: date-time
DATE_TO:
type: string
description: The ending date of the returned positions
format: date-time
example:
DATA:
- MMSI: '538003913'
IMO: '9470959'
SHIP_ID: '713139'
LAT: '37.388430'
LON: '23.871230'
SPEED: '6'
HEADING: '104'
COURSE: '41'
STATUS: '0'
TIMESTAMP: '2020-10-15T12:21:44.000Z'
DSRC: TER
UTC_SECONDS: '45'
MARKET: SUPPORTING VESSELS
SHIPNAME: SUNNY STAR
SHIPTYPE: '89'
CALLSIGN: V7TZ6
FLAG: MH
LENGTH: '184'
WIDTH: '27.43'
GRT: '23313'
DWT: '37857'
DRAUGHT: '95'
YEAR_BUILT: '2010'
SHIP_COUNTRY: Marshall Is
SHIP_CLASS: HANDYSIZE
ROT: '0'
TYPE_NAME: Oil/Chemical Tanker
AIS_TYPE_SUMMARY: Tanker
DESTINATION: FOR ORDERS
ETA: '2020-10-14T12:00:00.000Z'
L_FORE: '5'
W_LEFT: '5'
CURRENT_PORT: ''
LAST_PORT: AGIOI THEODOROI
LAST_PORT_TIME: '2020-10-13T23:39:00.000Z'
CURRENT_PORT_ID: ''
CURRENT_PORT_UNLOCODE: ''
CURRENT_PORT_COUNTRY: ''
LAST_PORT_ID: '29'
LAST_PORT_UNLOCODE: GRAGT
LAST_PORT_COUNTRY: GR
NEXT_PORT_ID: ''
NEXT_PORT_UNLOCODE: ''
NEXT_PORT_NAME: ''
NEXT_PORT_COUNTRY: ''
ETA_CALC: ''
ETA_UPDATED: ''
DISTANCE_TO_GO: '0'
DISTANCE_TRAVELLED: '74'
AVG_SPEED: '12.6'
MAX_SPEED: '13.2'
METADATA:
CURSOR: abcdef
DATE_FROM: '2023-11-20 15:57:00'
DATE_TO: '2023-11-20 16:57:00'
200_MTA030AD_single:
title: Default
type: array
items:
type: object
properties:
MMSI:
type: string
description: Maritime Mobile Service Identity - a nine-digit number sent in digital form over a radio frequency
that identifies the vessel's transmitter station
IMO:
type: string
description: International Maritime Organisation number - a seven-digit number that uniquely identifies vessels
SHIP_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the subject vessel
LAT:
type: string
description: Latitude - a geographic coordinate that specifies the north-south position of the vessel on the Earth's
surface
LON:
type: string
description: Longitude - a geographic coordinate that specifies the east-west position of the vessel on the Earth's
surface
SPEED:
type: string
description: The speed (in knots x10) that the subject vessel is reporting according to AIS transmissions
HEADING:
type: string
description: The heading (in degrees) that the subject vessel is reporting according to AIS transmissions
COURSE:
type: string
description: The course (in degrees) that the subject vessel is reporting according to AIS transmissions
STATUS:
type: string
description: The AIS Navigational Status of the subject vessel as input by the vessel's crew. There might be discrepancies
with the vessel's detail page when vessel speed is near zero (0) knots
TIMESTAMP:
type: string
description: The date and time (in UTC) that the subject vessel's position or event was recorded by MarineTraffic
format: date-time
DSRC:
type: string
description: Describes whether the transmitted AIS message was received by a terrestrial, satellite or roaming
AIS antenna
UTC_SECONDS:
type: string
description: The time slot that the subject vessel uses to transmit information
MARKET:
type: string
description: Vessel's commercial market
SHIPNAME:
type: string
description: The Shipname of the subject vessel
SHIPTYPE:
type: string
description: The Shiptype of the subject vessel according to AIS transmissions
CALLSIGN:
type: string
description: A uniquely designated identifier for the vessel's transmitter station
FLAG:
type: string
description: The flag of the subject vessel according to AIS transmissions
LENGTH:
type: string
description: The overall Length (in metres) of the subject vessel
WIDTH:
type: string
description: The Breadth (in metres) of the subject vessel
GRT:
type: string
description: Gross Tonnage - unitless measure that calculates the moulded volume of all enclosed spaces of a ship
DWT:
type: string
description: Deadweight - a measure (in metric tons) of how much weight a vessel can safely carry (excluding the
vessel's own weight)
DRAUGHT:
type: string
description: The Draught (in metres x10) of the subject vessel according to the AIS transmissions
YEAR_BUILT:
type: string
description: The year that the subject vessel was built
SHIP_COUNTRY:
type: string
description: The vessel's country
SHIP_CLASS:
type: string
description: Vessel's class based on commercial market, capacity and/or dimensions
ROT:
type: string
description: Rate of Turn
TYPE_NAME:
type: string
description: The MarineTraffic ship type of the vessel
AIS_TYPE_SUMMARY:
type: string
description: Further explanation of the SHIPTYPE ID
DESTINATION:
type: string
description: The Destination of the subject vessel according to the AIS transmissions
ETA:
type: string
description: The Estimated Time of Arrival to Destination of the subject vessel according to the AIS transmissions
format: date-time
L_FORE:
type: string
description: The relative distance from the AIS station of the vessel to the foremost of it (front / bow)
W_LEFT:
type: string
description: The relative distance from the AIS station of the vessel to the leftmost of it (left side / port)
LAST_PORT:
type: string
description: The Name of the Last Port the vessel has visited
LAST_PORT_TIME:
type: string
description: The Date and Time (in UTC) that the subject vessel departed from the Last Port
format: date-time
LAST_PORT_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the Last Port
LAST_PORT_UNLOCODE:
type: string
description: A uniquely assigned ID by United Nations for the Last Port
LAST_PORT_COUNTRY:
type: string
description: The Country that the Last Port is located at
CURRENT_PORT:
type: string
description: The name of the Port the subject vessel is currently in (NULL if the vessel is underway)
CURRENT_PORT_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the Current Port
CURRENT_PORT_UNLOCODE:
type: string
description: A uniquely assigned ID by United Nations for the Current Port
CURRENT_PORT_COUNTRY:
type: string
description: The Country that the Current Port is located at
NEXT_PORT_ID:
type: string
description: A uniquely assigned ID by MarineTraffic for the Next Port
NEXT_PORT_UNLOCODE:
type: string
description: A uniquely assigned ID by United Nations for the Next Port
NEXT_PORT_NAME:
type: string
description: The Name of the Next Port as derived by MarineTraffic based on the subject vessel's reported Destination
NEXT_PORT_COUNTRY:
type: string
description: The Country that the Next Port is located at
ETA_CALC:
type: string
description: The Estimated Time of Arrival to Destination of the subject vessel according to the MarineTraffic
calculations
format: date-time
ETA_UPDATED:
type: string
description: The date and time (in UTC) that the ETA was calculated by MarineTraffic
format: date-time
DISTANCE_TO_GO:
type: string
description: The Remaining Distance (in NM) for the subject vessel to reach the reported Destination
DISTANCE_TRAVELLED:
type: string
description: The Distance (in NM) that the subject vessel has travelled since departing from Last Port
AVG_SPEED:
type: string
description: The average speed of the vessel (in knots) during the current voyage (since last port departure),
calculated using AIS position readings from the last 24 hours where speed exceeds 5 knots.
MAX_SPEED:
type: string
description: The maximum speed (in knots) recorded during the current voyage (since last port departure). This
value updates gradually and may lag behind the current speed following a sudden acceleration or shortly after
port departure.
example:
- MMSI: '538003913'
IMO: '9470959'
SHIP_ID: '713139'
LAT: '37.388430'
LON: '23.871230'
SPEED: '6'
HEADING: '104'
COURSE: '41'
STATUS: '0'
TIMESTAMP: '2020-10-15T12:21:44.000Z'
DSRC: TER
UTC_SECONDS: '45'
MARKET: SUPPORTING VESSELS
SHIPNAME: SUNNY STAR
SHIPTYPE: '89'
CALLSIGN: V7TZ6
FLAG: MH
LENGTH: '184'
WIDTH: '27.43'
GRT: '23313'
DWT: '37857'
DRAUGHT: '95'
YEAR_BUILT: '2010'
SHIP_COUNTRY: Marshall Is
SHIP_CLASS: HANDYSIZE
ROT: '0'
TYPE_NAME: Oil/Chemical Tanker
AIS_TYPE_SUMMARY: Tanker
DESTINATION: FOR ORDERS
ETA: '2020-10-14T12:00:00.000Z'
L_FORE: '5'
W_LEFT: '5'
CURRENT_PORT: ''
LAST_PORT: AGIOI THEODOROI
LAST_PORT_TIME: '2020-10-13T23:39:00.000Z'
CURRENT_PORT_ID: ''
CURRENT_PORT_UNLOCODE: ''
CURRENT_PORT_COUNTRY: ''
LAST_PORT_ID: '29'
LAST_PORT_UNLOCODE: GRAGT
LAST_PORT_COUNTRY: GR
NEXT_PORT_ID: ''
NEXT_PORT_UNLOCODE: ''
NEXT_PORT_NAME: ''
NEXT_PORT_COUNTRY: ''
ETA_CALC: ''
ETA_UPDATED: ''
DISTANCE_TO_GO: '0'
DISTANCE_TRAVELLED: '74'
AVG_SPEED: '12.6'
MAX_SPEED: '13.2'