Get Fleet Composition
Production
https://api.polestar-production.com
Production
https://api.polestar-production.com
GET
https://api.polestar-production.com
without listing every vessel. The response has five sections:
summary: vessel count after filtering, average age, total deadweightand the number of flag states.
type_and_class: counts and percentages by vessel type and vessel class.registration_and_flag: the most common ports of registry and flagstates.
build_and_origin: the most common countries of build and builders,and an age profile.
size_and_dimensions: distributions of deadweight, gross tonnage,length overall, beam and draught.
Unknown countsvessels with no value for that attribute. Where a section reports
vessels_with_data, that is the number of vessels the figures arebased on.
flag_code, vessel_type andvessel_class; repeat a parameter for several values. Only the user whocreated the fleet can read its composition.
Request
Path Params
Query Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.polestar-production.com/fleet-management/v2/fleets/550e8400-e29b-41d4-a716-446655440000/composition?flag_code=PAN&flag_code=MLT&vessel_type=Bulk%20Carrier&vessel_class=Panamax' \
--header 'api-key: <api-key>'Response Response Example
200 - Success Example
{
"meta": {
"request_id": "f7a8b9c0-d1e2-3456-f789-0123456789ab",
"request_timestamp": "2026-09-08T10:00:00Z"
},
"fleet_information": {
"fleet_id": "550e8400-e29b-41d4-a716-446655440000",
"name": "North Sea Tanker Fleet",
"vessel_count": 40
},
"data": {
"summary": {
"vessels": {
"filtered_count": 40
},
"average_age": {
"unit": "years",
"value": 13.8
},
"total_dwt": {
"unit": "mt",
"value": 2.3,
"vessels_with_data": 19
},
"flag_states_count": 5
},
"type_and_class": {
"vessel_type": [
{
"label": "Tanker",
"count": 13,
"percentage": 32.5
},
{
"label": "Bulk Carrier",
"count": 8,
"percentage": 20
},
{
"label": "Container",
"count": 8,
"percentage": 20
},
{
"label": "General Cargo",
"count": 6,
"percentage": 15
},
{
"label": "Chemical Tanker",
"count": 3,
"percentage": 7.5
},
{
"label": "LPG Carrier",
"count": 1,
"percentage": 2.5
},
{
"label": "Unknown",
"count": 1,
"percentage": 2.5
}
],
"vessel_class": [
{
"label": "Panamax",
"count": 8,
"percentage": 20
},
{
"label": "Capesize",
"count": 6,
"percentage": 15
},
{
"label": "VLCC",
"count": 6,
"percentage": 15
},
{
"label": "Deep-sea",
"count": 4,
"percentage": 10
},
{
"label": "Handysize",
"count": 4,
"percentage": 10
},
{
"label": "Post-Panamax",
"count": 3,
"percentage": 7.5
},
{
"label": "Suezmax",
"count": 3,
"percentage": 7.5
},
{
"label": "ULCV",
"count": 2,
"percentage": 5
},
{
"label": "Aframax",
"count": 1,
"percentage": 2.5
},
{
"label": "Unknown",
"count": 3,
"percentage": 7.5
}
]
},
"registration_and_flag": {
"port_of_registry": {
"total_categories": 7,
"items": [
{
"label": "Panama City",
"count": 14,
"percentage": 35
},
{
"label": "Majuro",
"count": 3,
"percentage": 7.5
},
{
"label": "Oslo",
"count": 3,
"percentage": 7.5
},
{
"label": "Nassau",
"count": 2,
"percentage": 5
},
{
"label": "Valletta",
"count": 2,
"percentage": 5
},
{
"label": "Limassol",
"count": 1,
"percentage": 2.5
},
{
"label": "Unknown",
"count": 15,
"percentage": 37.5
}
]
},
"vessel_flag": {
"total_categories": 6,
"items": [
{
"label": "Panama",
"count": 14,
"percentage": 35
},
{
"label": "Marshall Islands",
"count": 3,
"percentage": 7.5
},
{
"label": "Norway",
"count": 3,
"percentage": 7.5
},
{
"label": "Bahamas",
"count": 2,
"percentage": 5
},
{
"label": "Malta",
"count": 2,
"percentage": 5
},
{
"label": "Unknown",
"count": 16,
"percentage": 40
}
]
}
},
"build_and_origin": {
"country_of_build": {
"total_categories": 6,
"items": [
{
"label": "South Korea",
"count": 12,
"percentage": 30
},
{
"label": "Japan",
"count": 9,
"percentage": 22.5
},
{
"label": "China",
"count": 7,
"percentage": 17.5
},
{
"label": "Norway",
"count": 4,
"percentage": 10
},
{
"label": "Germany",
"count": 3,
"percentage": 7.5
},
{
"label": "Unknown",
"count": 5,
"percentage": 12.5
}
]
},
"builder": {
"total_categories": 6,
"items": [
{
"label": "Hyundai Heavy Industries",
"count": 6,
"percentage": 15
},
{
"label": "Japan Marine United",
"count": 6,
"percentage": 15
},
{
"label": "Hanwha Ocean",
"count": 5,
"percentage": 12.5
},
{
"label": "Jiangnan Shipyard",
"count": 4,
"percentage": 10
},
{
"label": "Yangzijiang Shipbuilding",
"count": 3,
"percentage": 7.5
},
{
"label": "Unknown",
"count": 16,
"percentage": 40
}
]
},
"age_profile": [
{
"label": "0-5",
"count": 2,
"percentage": 5
},
{
"label": "6-10",
"count": 15,
"percentage": 37.5
},
{
"label": "11-15",
"count": 7,
"percentage": 17.5
},
{
"label": "16-20",
"count": 8,
"percentage": 20
},
{
"label": "21+",
"count": 8,
"percentage": 20
}
]
},
"size_and_dimensions": {
"size": {
"deadweight_tonnage": {
"unit": "t",
"vessels_with_data": 19,
"items": [
{
"label": "< 50k",
"count": 2,
"percentage": 5
},
{
"label": "50-100k",
"count": 4,
"percentage": 10
},
{
"label": "100-150k",
"count": 6,
"percentage": 15
},
{
"label": "150-200k",
"count": 5,
"percentage": 12.5
},
{
"label": "200k+",
"count": 2,
"percentage": 5
},
{
"label": "Unknown",
"count": 21,
"percentage": 52.5
}
]
},
"gross_tonnage": {
"unit": "gt",
"vessels_with_data": 19,
"items": [
{
"label": "< 30k",
"count": 0,
"percentage": 0
},
{
"label": "30–60k",
"count": 3,
"percentage": 7.5
},
{
"label": "60–100k",
"count": 5,
"percentage": 12.5
},
{
"label": "100–150k",
"count": 6,
"percentage": 15
},
{
"label": "150k+",
"count": 5,
"percentage": 12.5
},
{
"label": "Unknown",
"count": 21,
"percentage": 52.5
}
]
}
},
"dimensions": {
"length_overall": {
"unit": "m",
"vessels_with_data": 39,
"items": [
{
"label": "< 150 m",
"count": 0,
"percentage": 0
},
{
"label": "150–200 m",
"count": 8,
"percentage": 20
},
{
"label": "200–250 m",
"count": 13,
"percentage": 32.5
},
{
"label": "250–300 m",
"count": 10,
"percentage": 25
},
{
"label": "300 m+",
"count": 8,
"percentage": 20
},
{
"label": "Unknown",
"count": 1,
"percentage": 2.5
}
]
},
"beam": {
"unit": "m",
"vessels_with_data": 39,
"items": [
{
"label": "< 25 m",
"count": 1,
"percentage": 2.5
},
{
"label": "25–32 m",
"count": 6,
"percentage": 15
},
{
"label": "32–40 m",
"count": 12,
"percentage": 30
},
{
"label": "40–50 m",
"count": 11,
"percentage": 27.5
},
{
"label": "50 m+",
"count": 9,
"percentage": 22.5
},
{
"label": "Unknown",
"count": 1,
"percentage": 2.5
}
]
},
"draught": {
"unit": "m",
"vessels_with_data": 39,
"items": [
{
"label": "< 8 m",
"count": 0,
"percentage": 0
},
{
"label": "8-12 m",
"count": 2,
"percentage": 5
},
{
"label": "12-16 m",
"count": 9,
"percentage": 22.5
},
{
"label": "16-20 m",
"count": 14,
"percentage": 35
},
{
"label": "20 m+",
"count": 14,
"percentage": 35
},
{
"label": "Unknown",
"count": 1,
"percentage": 2.5
}
]
}
}
}
}
}Modified at 2026-10-21 13:49:55