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