---
title: "Get all marine fuel ports"
method: GET
path: "/v1/marine-ports"
tags: ["Marine Fuels"]
---

# Get all marine fuel ports

`GET /v1/marine-ports`

## Request

- Base URL: `https://api.oilpriceapi.com`
- URL: `https://api.oilpriceapi.com/v1/marine-ports`
- Auth: API key in header `Authorization`

Retrieve all available marine fuel ports with their details and capabilities.
Returns port information including coordinates, fuel services, and trading hours.

## Query parameters

- `region` 'Asia' | 'Europe' | 'Americas' | 'Middle East'
- `country` string
- `major_ports` boolean

## Response `200`

List of marine fuel ports

- MarinePortsResponse
  - `status` string
  - `data` object
    - `ports` MarinePort[]
      - `code` string: Unique port identifier
      - `name` string: Port name
      - `country` string: Country where port is located
      - `region` string: Geographic region
      - `major_port` boolean: Whether this is a major bunkering hub
      - `coordinates` object
        - `latitude` number, float
        - `longitude` number, float
      - `fuel_services` string[]: Available fuel types at this port
      - `trading_hours` string: Port operating hours
    - `count` integer
    - `filters` object
      - `region` string, nullable
      - `country` string, nullable
      - `major_ports_only` boolean

## Other responses

- `401`: Unauthorized - Invalid API key
- `429`: Rate limit exceeded
- `500`: Unexpected server error. Retry transient failures with bounded backoff and retain the request ID when contacting support.

---

[API](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1.md) - [All operations](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1/revisions/7f8b4d763210?raw)
