{
    "info": {
        "name": "Vessels API",
        "_postman_id": "vessels-api-v1",
        "description": "Real-time AIS vessel tracking, fleet management, port congestion, and IMO CII emissions scoring. Base URL: https://vessels-api.com/api/V1",
        "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
    },
    "auth": {
        "type": "apikey",
        "apikey": [
            {
                "key": "key",
                "value": "X-API-Key",
                "type": "string"
            },
            {
                "key": "value",
                "value": "YOUR_API_KEY",
                "type": "string"
            },
            {
                "key": "in",
                "value": "header",
                "type": "string"
            }
        ]
    },
    "item": [
        {
            "name": "Vessel Intelligence",
            "item": [
                {
                    "name": "GET /vessels/search",
                    "request": {
                        "auth": {
                            "type": "inherit"
                        },
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "https://vessels-api.com/api/V1/vessels/search",
                            "host": [
                                "vessels-api.com"
                            ],
                            "path": [
                                "api",
                                "V1",
                                "vessels",
                                "search"
                            ],
                            "query": [
                                {
                                    "key": "query",
                                    "value": "atlantic",
                                    "disabled": false,
                                    "description": "Fuzzy vessel name search"
                                },
                                {
                                    "key": "flag",
                                    "value": "Panama",
                                    "disabled": false,
                                    "description": "Flag state"
                                },
                                {
                                    "key": "ship_type",
                                    "value": "",
                                    "disabled": true,
                                    "description": "e.g. Container Ship, Tanker"
                                },
                                {
                                    "key": "imo",
                                    "value": "",
                                    "disabled": true,
                                    "description": "Filter by IMO number"
                                },
                                {
                                    "key": "mmsi",
                                    "value": "",
                                    "disabled": true,
                                    "description": "Filter by MMSI number"
                                },
                                {
                                    "key": "min_dwt",
                                    "value": "",
                                    "disabled": true,
                                    "description": "Min deadweight tonnage"
                                },
                                {
                                    "key": "max_dwt",
                                    "value": "",
                                    "disabled": true,
                                    "description": "Max deadweight tonnage"
                                },
                                {
                                    "key": "per_page",
                                    "value": "20",
                                    "disabled": false,
                                    "description": "Results per page (max 100)"
                                },
                                {
                                    "key": "page",
                                    "value": "1",
                                    "disabled": false,
                                    "description": "Page number"
                                }
                            ]
                        }
                    },
                    "response": []
                },
                {
                    "name": "GET /vessels/track",
                    "request": {
                        "auth": {
                            "type": "inherit"
                        },
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "https://vessels-api.com/api/V1/vessels/track",
                            "host": [
                                "vessels-api.com"
                            ],
                            "path": [
                                "api",
                                "V1",
                                "vessels",
                                "track"
                            ],
                            "query": [
                                {
                                    "key": "mmsi",
                                    "value": "258785000",
                                    "disabled": false,
                                    "description": "MMSI number (imo or mmsi required)"
                                },
                                {
                                    "key": "imo",
                                    "value": "",
                                    "disabled": true,
                                    "description": "IMO number"
                                },
                                {
                                    "key": "hours",
                                    "value": "24",
                                    "disabled": false,
                                    "description": "History window in hours (max 168)"
                                },
                                {
                                    "key": "include_route",
                                    "value": "true",
                                    "disabled": false,
                                    "description": "Include active voyage route"
                                },
                                {
                                    "key": "include_predicted_eta",
                                    "value": "false",
                                    "disabled": false,
                                    "description": "Predicted ETA from internal model"
                                },
                                {
                                    "key": "include_weather",
                                    "value": "false",
                                    "disabled": false,
                                    "description": "Weather overlay at current position"
                                }
                            ]
                        }
                    },
                    "response": []
                },
                {
                    "name": "GET /vessels/nearby",
                    "request": {
                        "auth": {
                            "type": "inherit"
                        },
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "https://vessels-api.com/api/V1/vessels/nearby",
                            "host": [
                                "vessels-api.com"
                            ],
                            "path": [
                                "api",
                                "V1",
                                "vessels",
                                "nearby"
                            ],
                            "query": [
                                {
                                    "key": "latitude",
                                    "value": "-34.60",
                                    "disabled": false,
                                    "description": "Center latitude"
                                },
                                {
                                    "key": "longitude",
                                    "value": "-58.38",
                                    "disabled": false,
                                    "description": "Center longitude"
                                },
                                {
                                    "key": "radius",
                                    "value": "30",
                                    "disabled": false,
                                    "description": "Radius in nautical miles (max 200)"
                                },
                                {
                                    "key": "ship_type",
                                    "value": "",
                                    "disabled": true,
                                    "description": "Filter by vessel type"
                                },
                                {
                                    "key": "limit",
                                    "value": "50",
                                    "disabled": false,
                                    "description": "Max results"
                                }
                            ]
                        }
                    },
                    "response": []
                },
                {
                    "name": "GET /vessels/analytics",
                    "request": {
                        "auth": {
                            "type": "inherit"
                        },
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "https://vessels-api.com/api/V1/vessels/analytics",
                            "host": [
                                "vessels-api.com"
                            ],
                            "path": [
                                "api",
                                "V1",
                                "vessels",
                                "analytics"
                            ],
                            "query": [
                                {
                                    "key": "type",
                                    "value": "vessel",
                                    "disabled": false,
                                    "description": "vessel | port | fleet"
                                },
                                {
                                    "key": "mmsi",
                                    "value": "258785000",
                                    "disabled": false,
                                    "description": "MMSI (for type=vessel)"
                                },
                                {
                                    "key": "period",
                                    "value": "7d",
                                    "disabled": false,
                                    "description": "24h | 7d | 30d | 90d"
                                }
                            ]
                        }
                    },
                    "response": []
                }
            ]
        },
        {
            "name": "Fleet Operations",
            "item": [
                {
                    "name": "POST /vessels/fleet",
                    "request": {
                        "auth": {
                            "type": "inherit"
                        },
                        "method": "POST",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application/json"
                            }
                        ],
                        "body": {
                            "mode": "raw",
                            "raw": "{\n    \"vessels\": [\n        {\n            \"imo\": \"9122556\"\n        },\n        {\n            \"mmsi\": \"309374000\"\n        }\n    ],\n    \"include_positions\": true,\n    \"include_routes\": true\n}",
                            "options": {
                                "raw": {
                                    "language": "json"
                                }
                            }
                        },
                        "url": {
                            "raw": "https://vessels-api.com/api/V1/vessels/fleet",
                            "host": [
                                "vessels-api.com"
                            ],
                            "path": [
                                "api",
                                "V1",
                                "vessels",
                                "fleet"
                            ]
                        }
                    },
                    "response": []
                },
                {
                    "name": "GET /vessels/green",
                    "request": {
                        "auth": {
                            "type": "inherit"
                        },
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "https://vessels-api.com/api/V1/vessels/green",
                            "host": [
                                "vessels-api.com"
                            ],
                            "path": [
                                "api",
                                "V1",
                                "vessels",
                                "green"
                            ],
                            "query": [
                                {
                                    "key": "mmsi",
                                    "value": "258785000",
                                    "disabled": false,
                                    "description": "MMSI number (imo or mmsi required)"
                                },
                                {
                                    "key": "imo",
                                    "value": "",
                                    "disabled": true,
                                    "description": "IMO number"
                                },
                                {
                                    "key": "period",
                                    "value": "30d",
                                    "disabled": false,
                                    "description": "24h | 7d | 30d | 1y"
                                }
                            ]
                        }
                    },
                    "response": []
                }
            ]
        },
        {
            "name": "Port Intelligence",
            "item": [
                {
                    "name": "GET /ports/congestion",
                    "request": {
                        "auth": {
                            "type": "inherit"
                        },
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "https://vessels-api.com/api/V1/ports/congestion",
                            "host": [
                                "vessels-api.com"
                            ],
                            "path": [
                                "api",
                                "V1",
                                "ports",
                                "congestion"
                            ],
                            "query": [
                                {
                                    "key": "port_id",
                                    "value": "ARBUE",
                                    "disabled": false,
                                    "description": "Port identifier"
                                },
                                {
                                    "key": "period",
                                    "value": "7d",
                                    "disabled": false,
                                    "description": "24h | 3d | 7d"
                                }
                            ]
                        }
                    },
                    "response": []
                },
                {
                    "name": "GET /ports",
                    "request": {
                        "auth": {
                            "type": "inherit"
                        },
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "https://vessels-api.com/api/V1/ports",
                            "host": [
                                "vessels-api.com"
                            ],
                            "path": [
                                "api",
                                "V1",
                                "ports"
                            ],
                            "query": []
                        }
                    },
                    "response": []
                },
                {
                    "name": "GET /ports/data",
                    "request": {
                        "auth": {
                            "type": "inherit"
                        },
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "https://vessels-api.com/api/V1/ports/data",
                            "host": [
                                "vessels-api.com"
                            ],
                            "path": [
                                "api",
                                "V1",
                                "ports",
                                "data"
                            ],
                            "query": [
                                {
                                    "key": "port_id",
                                    "value": "ARBUE",
                                    "disabled": false,
                                    "description": "Port identifier"
                                }
                            ]
                        }
                    },
                    "response": []
                },
                {
                    "name": "GET /port/expected-arrivals",
                    "request": {
                        "auth": {
                            "type": "inherit"
                        },
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "https://vessels-api.com/api/V1/port/expected-arrivals",
                            "host": [
                                "vessels-api.com"
                            ],
                            "path": [
                                "api",
                                "V1",
                                "port",
                                "expected-arrivals"
                            ],
                            "query": [
                                {
                                    "key": "port_id",
                                    "value": "ARBUE",
                                    "disabled": false,
                                    "description": "Port identifier"
                                }
                            ]
                        }
                    },
                    "response": []
                },
                {
                    "name": "GET /port/activity",
                    "request": {
                        "auth": {
                            "type": "inherit"
                        },
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "https://vessels-api.com/api/V1/port/activity",
                            "host": [
                                "vessels-api.com"
                            ],
                            "path": [
                                "api",
                                "V1",
                                "port",
                                "activity"
                            ],
                            "query": [
                                {
                                    "key": "port_id",
                                    "value": "ARBUE",
                                    "disabled": false,
                                    "description": "Port identifier"
                                }
                            ]
                        }
                    },
                    "response": []
                }
            ]
        },
        {
            "name": "Legacy Endpoints",
            "item": [
                {
                    "name": "GET /vessel/info",
                    "request": {
                        "auth": {
                            "type": "inherit"
                        },
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "https://vessels-api.com/api/V1/vessel/info",
                            "host": [
                                "vessels-api.com"
                            ],
                            "path": [
                                "api",
                                "V1",
                                "vessel",
                                "info"
                            ],
                            "query": [
                                {
                                    "key": "imoCode",
                                    "value": "9122556",
                                    "disabled": false,
                                    "description": "IMO number (7 digits)"
                                }
                            ]
                        }
                    },
                    "response": []
                },
                {
                    "name": "GET /vessel/route",
                    "request": {
                        "auth": {
                            "type": "inherit"
                        },
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "https://vessels-api.com/api/V1/vessel/route",
                            "host": [
                                "vessels-api.com"
                            ],
                            "path": [
                                "api",
                                "V1",
                                "vessel",
                                "route"
                            ],
                            "query": [
                                {
                                    "key": "imoCode",
                                    "value": "9122556",
                                    "disabled": false,
                                    "description": "IMO number (7 digits)"
                                }
                            ]
                        }
                    },
                    "response": []
                },
                {
                    "name": "GET /vessel/position",
                    "request": {
                        "auth": {
                            "type": "inherit"
                        },
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "https://vessels-api.com/api/V1/vessel/position",
                            "host": [
                                "vessels-api.com"
                            ],
                            "path": [
                                "api",
                                "V1",
                                "vessel",
                                "position"
                            ],
                            "query": [
                                {
                                    "key": "imoCode",
                                    "value": "9122556",
                                    "disabled": false,
                                    "description": "IMO number (7 digits)"
                                }
                            ]
                        }
                    },
                    "response": []
                },
                {
                    "name": "GET /vessel/mmsi-position",
                    "request": {
                        "auth": {
                            "type": "inherit"
                        },
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "https://vessels-api.com/api/V1/vessel/mmsi-position",
                            "host": [
                                "vessels-api.com"
                            ],
                            "path": [
                                "api",
                                "V1",
                                "vessel",
                                "mmsi-position"
                            ],
                            "query": [
                                {
                                    "key": "mmsiCode",
                                    "value": "258785000",
                                    "disabled": false,
                                    "description": "MMSI number (9 digits)"
                                }
                            ]
                        }
                    },
                    "response": []
                },
                {
                    "name": "GET /vessel/port",
                    "request": {
                        "auth": {
                            "type": "inherit"
                        },
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "https://vessels-api.com/api/V1/vessel/port",
                            "host": [
                                "vessels-api.com"
                            ],
                            "path": [
                                "api",
                                "V1",
                                "vessel",
                                "port"
                            ],
                            "query": [
                                {
                                    "key": "port_id",
                                    "value": "ARBUE",
                                    "disabled": false,
                                    "description": "Port identifier"
                                }
                            ]
                        }
                    },
                    "response": []
                },
                {
                    "name": "GET /vessel/port/mmsi",
                    "request": {
                        "auth": {
                            "type": "inherit"
                        },
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "https://vessels-api.com/api/V1/vessel/port/mmsi",
                            "host": [
                                "vessels-api.com"
                            ],
                            "path": [
                                "api",
                                "V1",
                                "vessel",
                                "port",
                                "mmsi"
                            ],
                            "query": [
                                {
                                    "key": "mmsiCode",
                                    "value": "258785000",
                                    "disabled": false,
                                    "description": "MMSI number (9 digits)"
                                }
                            ]
                        }
                    },
                    "response": []
                }
            ]
        }
    ],
    "variable": [
        {
            "key": "base_url",
            "value": "https://vessels-api.com/api/V1"
        }
    ]
}