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
    }
  }
}

Examples

Get all ports

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

Get Asian ports only

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

Get major ports only

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

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

This endpoint returns our 8 major bunkering hubs with direct price feeds. If you need broader coverage, our Ship&Bunker Data Connector provides access to 218 ports across Americas, EMEA, and Asia-Pacific.

Coverage	This Endpoint	BYOS Connector
Ports	8 major hubs	218 ports
Regions	4	3 (detailed)
Fuel Types	4	3 (VLSFO, MGO, IFO380)
Data Source	Direct feeds	Your Ship&Bunker subscription

The BYOS (Bring Your Own Subscription) connector lets you connect your existing Ship&Bunker subscription and access all 218 ports via API.

Learn more about the Ship&Bunker Data Connector →