# List Marine Fuel Ports

Get a list of all available marine fuel ports with their details and capabilities.

# Endpoint

GET /v1/marine-ports

# Authentication

This endpoint requires authentication. Include your API key in the request header:

Authorization: Token YOUR_API_KEY

# Query Parameters

Parameter	Type	Description
`region`	string	Filter by geographic region (Asia, Europe, Americas, Middle East)
`country`	string	Filter by country code
`major_ports`	boolean	Return only major bunkering hubs

# Response

{
  "status": "success",
  "data": {
    "ports": [
      {
        "code": "SGSIN",
        "name": "Singapore",
        "country": "Singapore",
        "region": "Asia",
        "major_port": true,
        "coordinates": {
          "latitude": 1.2966,
          "longitude": 103.7764
        },
        "fuel_services": [
          "MGO_05S",
          "VLSFO",
          "HFO_380",
          "HFO_180"
        ],
        "trading_hours": "24/7"
      },
      // ... more ports
    ],
    "count": 8,
    "filters": {
      "region": null,
      "country": null,
      "major_ports_only": false
    }
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

# Examples

# Get all ports

curl -H "Authorization: Token YOUR_API_KEY" \
  https://api.oilpriceapi.com/v1/marine-ports

1
2

# Get Asian ports only

curl -H "Authorization: Token YOUR_API_KEY" \
  https://api.oilpriceapi.com/v1/marine-ports?region=Asia

1
2

# Get major ports only

curl -H "Authorization: Token YOUR_API_KEY" \
  https://api.oilpriceapi.com/v1/marine-ports?major_ports=true

1
2

# Response Fields

code: Unique port identifier (e.g., SGSIN for Singapore)
name: Port name
country: Country where port is located
region: Geographic region (Asia, Europe, Americas, Middle East)
major_port: Boolean indicating if this is a major bunkering hub
coordinates: Latitude and longitude of the port
fuel_services: Array of available fuel types at this port
trading_hours: Operating hours for bunker operations

← Get Commodity Details Get Port Details with Prices →