Skip to main content
GET
/
port-calls-by-port
Port Calls By Port
curl --request GET \
  --url https://datadocked.com/api/vessels_operations/port-calls-by-port \
  --header 'x-api-key: <api-key>'
{
  "status_code": 123,
  "detail": {
    "arrival": {
      "total": 123,
      "pages": 123,
      "list": [
        {
          "mmsi": 123,
          "name": "<string>",
          "imo": 123,
          "type": "<string>",
          "year": 123,
          "country": "<string>",
          "a2": "<string>",
          "gt": 123,
          "dw": 123,
          "sa": true,
          "sizes": "<string>",
          "formattedETA": "<string>"
        }
      ]
    }
  }
}
Retrieve vessel traffic data for a specific port including arrivals, departures, expected vessels, and vessels currently in port.
Credits: 50 credits per request

​
Search Types

Use the search_type parameter to filter results:
TypeDescription
arrivalRecently arrived vessels
departureRecently departed vessels
expectedVessels expected to arrive
in_portVessels currently in port

​
Port Codes

Use UN/LOCODE format for the port_call parameter:
PortUN/LOCODE
Barcelona, SpainESBCN
Rotterdam, NetherlandsNLRTM
SingaporeSGSIN
Shanghai, ChinaCNSHA
Los Angeles, USAUSLAX

​
Pagination

Results are paginated. Use the page parameter (starting from 1) to navigate through results.

​
Optional Filtering

Use vessel_type to filter results by vessel category.

​
Response Data

  • Total: Total number of vessels matching criteria
  • Pages: Total pages available
  • List: Array of vessel data including MMSI, name, IMO, type, country, dimensions, and formatted ETA

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

​
port_call
string
required

The UN/LOCODE of the port you want to query (e.g., ESBCN for Barcelona).

​
search_type
enum<string>
required

The type of search to perform.

Available options:
arrival,
departure,
expected,
in_port
​
page
integer
required

Page number for pagination. Pagination starts with page number 1.

Required range: x >= 1
​
vessel_type
string

Filter results by vessel type.

Response

Successful response with port traffic data

​
status_code
integer
​
detail
object