---
title: "Get Port Details by unlocode"
method: GET
path: "/ports/{unlocode}"
tags: ["Ports"]
---

# Get Port Details by unlocode

`GET /ports/{unlocode}`

## Request

- Base URL: `https://api.sinay.ai/ports-intelligence/api/v1`
- URL: `https://api.sinay.ai/ports-intelligence/api/v1/ports/{unlocode}`
- Auth: API key in header `API_KEY`

Retrieve detailed informations about a specific port by its UNLOCODE. It include the berth occupation rate and the difference with the average one.

## Path parameters

- `unlocode` string, required

## Response `200`

Successful response

- PortDetails
  - `portDetails` Port
    - `name` string: Name of the port
    - `longitude` number, float: Longitude coordinate
    - `latitude` number, float: Latitude coordinate
    - `unlocode` string: UN/LOCODE of the port
    - `countryName` string: Country name
    - `countryCode` string: ISO country code
  - `portOccupationData` object, nullable
    - `portOccupationLevel` number, float: Current port occupation percentage
    - `portOccupationDifferenceFromAverage` number, float: Difference with average occupation

## Other responses

- `401`: Authentication information is missing or invalid
- `404`: The requested resource was not found
- `500`: Internal server error

---

[API](https://skmtc.dev/safecube/apis/safecube-ports-intelligence-api.md) - [All operations](https://skmtc.dev/safecube/apis/safecube-ports-intelligence-api/llms.txt) - [OpenAPI document](https://skmtc.dev/safecube/apis/safecube-ports-intelligence-api/revisions/2174dfde250f?raw)