openapi: 3.0.2
info:
title: MarineTraffic Events AIS API Vessel Positions (Legacy API) API
version: 1.0.0
description: Port calls, berth calls, and event timelines for single vessels and entire ports — surfacing every arrival, departure, and berth touch detected by the global AIS network.
contact:
name: MarineTraffic
url: https://www.marinetraffic.com/
servers:
- url: https://services.marinetraffic.com/api
tags:
- name: Vessel Positions (Legacy API)
paths:
/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"
components:
schemas:
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_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'
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_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_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'
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_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_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_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_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
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_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_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_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_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_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_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_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: ''
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_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_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'
parameters:
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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_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
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
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
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
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
api_key:
name: api_key
in: path
description: 'API key: 40-character hexadecimal number'
required: true
schema:
type: string
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
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
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
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
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
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
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
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
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
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
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