Vessel Operations

Get Satellite Historical Vessel Data

Retrieve a combined satellite and terrestrial AIS track for a vessel. Available only on the satellite data plan; other accounts receive HTTP 400 and are not charged. Positions are sorted oldest to newest. Pricing is 5 credits per unique date with positions in the results; your balance must cover 5 credits per day of the requested range before the request runs, and a response with no positions is free. One request covers up to 90 days, history extends back 2 years, and a 90-day request can take up to about 30 seconds — set a client timeout of at least 60 seconds. Rate limit: 15 requests/min.

GET

get-vessel-satellite-historical-data

curl --request GET \
  --url https://datadocked.com/api/vessels_operations/get-vessel-satellite-historical-data \
  --header 'x-api-key: <api-key>'

import requests

url = "https://datadocked.com/api/vessels_operations/get-vessel-satellite-historical-data"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://datadocked.com/api/vessels_operations/get-vessel-satellite-historical-data', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://datadocked.com/api/vessels_operations/get-vessel-satellite-historical-data",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://datadocked.com/api/vessels_operations/get-vessel-satellite-historical-data"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://datadocked.com/api/vessels_operations/get-vessel-satellite-historical-data")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "count": 123,
  "response": {
    "status": "<string>",
    "data": [
      {
        "lat": 123,
        "lng": 123,
        "course": 123,
        "speed": 123,
        "time": "2023-11-07T05:31:56Z"
      }
    ]
  }
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

Retrieve a combined satellite and terrestrial AIS track for a vessel, sorted from oldest to newest.

This endpoint is available only on the satellite data plan. Requests from other accounts return HTTP 400 with the message "This endpoint is available only for the satellite data plan." and are not charged.

Credits: 5 credits per unique date with positions in the results (variable total). A response with no positions is free.

Date Format

Dates must be provided in ISO 8601 format:

from_date=2026-01-01T00:00:00Z
to_date=2026-03-31T23:59:59Z

Limits

Maximum date range: 90 days per request
Historical data extends back 2 years
A single request can return tens of thousands of positions

To cover a period longer than 90 days, split it into consecutive windows of 90 days or less and send one request per window.

Pricing & Pre-authorization

Credits are calculated per unique calendar date that has positions in the results. Before the request runs, your balance must cover 5 credits per day of the requested range (even if some days end up without positions).

Date Range	Pre-authorized Credits
1 day	5 credits
1 week	35 credits
90 days	450 credits

Only dates that actually return positions are billed.

Client Timeout

A 90-day request can take up to about 30 seconds and return tens of thousands of positions. Set a client timeout of at least 60 seconds.

Errors

400 "This endpoint is available only for the satellite data plan." — Account is not on the satellite plan.
400 "History is available for the last 2 years only." — from_date is older than 2 years.
400 — to_date in the future, to_date not after from_date, or range exceeds 90 days.

Response Fields

count: Number of unique dates with positions (used to compute credit charge)
response.status: "success" or an error description
response.data[]: Position records sorted by time (oldest first), each with:
- lat: Latitude in decimal degrees
- lng: Longitude in decimal degrees
- course: Course over ground in degrees (null when not available)
- speed: Speed over ground in knots (null when not available)
- time: ISO 8601 UTC timestamp

Authorizations

x-api-key

string

header

required

Your personal API key found in your profile dashboard at https://datadocked.com/dashboard/my_keys

Query Parameters

imo_or_mmsi

string

required

The IMO or MMSI number of the vessel you want to retrieve the satellite and terrestrial track for.

from_date

string<date-time>

required

Beginning of the date range in ISO 8601 format. Must be within the last 2 years. The range between from_date and to_date must be 90 days max.

to_date

string<date-time>

required

End of the date range in ISO 8601 format. Must not be in the future and must be later than from_date. The range between from_date and to_date must be 90 days max.

Response

Successful response with combined satellite and terrestrial positions

count

integer

Number of unique dates that have positions in the results. Credits are charged per date (5 credits each).

response

object

Wrapper object for the historical data response.

Show child attributes

Get Satellite Historical Vessel Data

curl --request GET \
  --url https://datadocked.com/api/vessels_operations/get-vessel-satellite-historical-data \
  --header 'x-api-key: <api-key>'

import requests

url = "https://datadocked.com/api/vessels_operations/get-vessel-satellite-historical-data"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://datadocked.com/api/vessels_operations/get-vessel-satellite-historical-data', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://datadocked.com/api/vessels_operations/get-vessel-satellite-historical-data",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://datadocked.com/api/vessels_operations/get-vessel-satellite-historical-data"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://datadocked.com/api/vessels_operations/get-vessel-satellite-historical-data")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "count": 123,
  "response": {
    "status": "<string>",
    "data": [
      {
        "lat": 123,
        "lng": 123,
        "course": 123,
        "speed": 123,
        "time": "2023-11-07T05:31:56Z"
      }
    ]
  }
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

Overview

Account

Vessel Operations

Port Operations

Get Satellite Historical Vessel Data

Date Format

Limits

Pricing & Pre-authorization

Client Timeout

Errors

Response Fields

Authorizations

Query Parameters

Response

​Date Format

​Limits

​Pricing & Pre-authorization

​Client Timeout

​Errors

​Response Fields

Authorizations

Query Parameters

Response

Date Format

Limits

Pricing & Pre-authorization

Client Timeout

Errors

Response Fields