---
title: "Search Ports"
method: GET
path: "/api/admin/port-master/ports"
tags: ["admin-ports"]
---

# Search Ports

`GET /api/admin/port-master/ports`

## Request

- Base URL: `https://grandline.luzomi.com`
- URL: `https://grandline.luzomi.com/api/admin/port-master/ports`
- Auth: none declared

Paginated port search. `polygon_count` drives the coverage badge.

## Query parameters

- `q` string, nullable: Substring of port name, or a UN/LOCODE
- `country_iso2` string, nullable
- `region_id` integer, nullable
- `area_id` integer, nullable
- `port_range_id` integer, nullable
- `has_polygons` boolean, nullable: true = only ports with ≥1 polygon; false = only ports with none
- `page` integer
- `page_size` integer

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/luzomi/apis/grandline-api.md) · [All operations](https://skmtc.dev/luzomi/apis/grandline-api/llms.txt) · [OpenAPI document](https://skmtc.dev/luzomi/apis/grandline-api/revisions/4ce06aea012b?raw)