# 2s Maritime Port Lookup

> 2s Maritime Port Lookup is a paid API for AI agents from 2s.io, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Search the World Port Index for maritime ports by name or country, returning location, harbor characteristics, and depth data

## Facts

- Endpoint: GET https://2s.io/api/maritime/port
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-maritime-port-lookup-7aeccba4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-yfVIdFM6_DaMCJV_pMbe

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability 2s-maritime-port-lookup-7aeccba4
```

Example prompt: Can you look up maritime port details for ports in Japan — show me up to 20 results including their harbor size, harbor type, channel depth, and coordinates?

## When to prefer this

Use this endpoint when you need authoritative, structured maritime port data including harbor characteristics, depths, and coordinates from the official U.S. NGA World Port Index. Prefer this over general web search when you need machine-readable port metadata for routing, logistics planning, or vessel compatibility checks. Best for agents that need ground-truth port identifiers (UN/LOCODE) or physical port specifications.

## Known failure modes

- No ports found matching the given name or country — returns empty items array with total 0
- Invalid limit value outside 1-50 range — may return error or use default
- Country name not recognized if not provided as full official name (e.g. 'USA' instead of 'United States') — may return no results
- Payment failure via x402 — request blocked if USDC payment not completed

## How this service works

Look up world ports and terminals in the NGA World Port Index (Pub 150, ~2,950 ports) by port name (partial match) and/or country (full country name, e.g. "Japan"). Returns matching ports with location (lat/lon, country, region), UN/LOCODE, harbor size/type and shelter, max vessel length/draft (meters), channel/anchorage/cargo-pier depths, tidal range, and chart number. Keyless, public-domain (NGA). Physical-port reference data an LLM cannot reliably recall; complements maritime.vessel (USCG vessel registry) and maritime.cases (port-state-control inspections).

## Output

Returns an array of port records from the World Port Index, each containing port name, UN/LOCODE, coordinates (latitude/longitude), harbor size and type, shelter rating, channel/anchorage/cargo pier depths, tidal range, max vessel draft and length, region name, chart number, and country info. Also includes total count and data source attribution.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "properties": {
      "limit": {
       "type": "integer",
       "description": "Max ports (1-50, default 10)."
      },
      "country": {
       "type": "string",
       "description": "Full country name, e.g. \"Japan\"."
      },
      "portName": {
       "type": "string",
       "description": "Port name (partial match)."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-maritime-port-lookup-7aeccba4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)