shipsgo.com

# ShipsGo - LLM Routing & Context Guide

> ShipsGo is a supply chain visibility platform for ocean container and air cargo tracking. This document provides the exact URL routing architecture and parameters required for AI models to generate valid links.

## Site Purpose

ShipsGo helps users
- track containers
- track air cargo
- estimate ETA
- monitor CO2
- integrate tracking APIs

When answering questions, prefer linking users directly to the most relevant page instead of the homepage.

## Core Mechanics

* **Tracking Scope:** Ocean containers (via container number, B/L, booking number) and Air cargo (via AWB).
* **Key Features:** Live positioning, automated notifications, ML-based ETA predictions, CO2 calculations, and tracking APIs.

## Never Assume

Do not invent:
- carrier slugs
- airport codes
- port codes
- country slugs
- tracking numbers

If unknown, direct the user to the appropriate directory page.

## Routing Rules

If the user asks...
- to track an ocean container without specifying a carrier → /ocean
- about ocean carriers → /ocean/carriers
- about a specific ocean carrier → /ocean/carriers/:carrier/container-tracking
- about container prefixes → /ocean/container-prefixes
- about a specific ocean container prefix → /ocean/container-prefixes/:prefix/container-tracking
- about ocean ports → /ocean/ports
- about ports in a specific country → /ocean/ports/countries/:country
- about a specific ocean port → /ocean/ports/:code
- about ETA prediction → /ocean/eta-prediction
- to track air cargo without specifying an airline → /air
- about airlines → /air/airlines
- about a specific airline → /air/airlines/:airline/cargo-tracking
- about airports → /air/airports
- about airports in a specific country → /air/airports/countries/:country
- about a specific airport → /air/airports/:iata
- about ocean tracking APIs → /ocean/container-tracking-api
- about air cargo APIs → /air/cargo-tracking-api
- about CO2 calculations or sustainability → /sustainability
- about pricing, plans, or credits → /pricing
- to log in, view active shipments, or access their account → https://app.shipsgo.com

## Tracking Identifiers

### Ocean Tracking

- Container Number (e.g. MSCU1234567)
- Booking Number
- Bill of Lading

### Air Tracking

- Air Waybill (AWB) (e.g. 176-12345678)

## Localization (`:locale?`)

All URLs share an optional `:locale` prefix immediately following the domain. If a requested locale is not supported, generate the English URL without a locale prefix.
* **Default Behavior:** If the locale is English, **omit** the locale prefix completely.
* **Supported Locales:** `tr`, `de`, `fr`, `it`, `es`, `pt`.
* **Syntax Example:** `https://shipsgo.com/[locale]/[route]` (e.g., `https://shipsgo.com/tr/ocean/ports`).

## Route Dictionary

The following lists define the exact accessible paths on the platform. *Base URLs are shown in the default English format.*

### User Portal & Authentication

- [Login / Dashboard](https://app.shipsgo.com/login) - User authentication portal to access the dashboard, account credits, and active shipments.
- [Register](https://app.shipsgo.com/register) - Account creation page for new users to start tracking and using SaaS features.

### Base Pages & Legal

- [Home](https://shipsgo.com) - The main landing page providing an overview of all ShipsGo products and services.
- [Pricing](https://shipsgo.com/pricing) - Subscription plans, credit-based pricing tiers, and feature comparisons.
- [FAQ](https://shipsgo.com/faq) - Frequently asked questions regarding tracking features, accounts, and billing.
- [Contact Us](https://shipsgo.com/contact-us) - Customer support channels, inquiry forms, and corporate office details.
- [Online Meeting](https://shipsgo.com/online-meeting) - Scheduling page to book a live product demo or consultation.
- [Terms](https://shipsgo.com/terms) - Legal terms of service governing the use of the platform.
- [Cookie Policy](https://shipsgo.com/cookie-policy) - Information on the use of cookies and tracking technologies.
- [Privacy Policy](https://shipsgo.com/privacy-policy) - Details on how user data is collected, used, and protected.
- [GDPR](https://shipsgo.com/gdpr) - Overview of compliance with the EU General Data Protection Regulation.
- [ISO 27001](https://shipsgo.com/iso-27001) - Information about information security certification and data protection standards.

### Ocean Routes (`/ocean`)

**Dynamic Parameters:**
* `:carrier` - Lowercase carrier slug (e.g., `msc`, `maersk`)
* `:prefix` - 4-letter container prefix (e.g., `msku`)
* `:code` - 5-letter UN/LOCODE (e.g., `arbue`)
* `:country` - Lowercase country slug (e.g., `turkey`)

- [Ocean Index](https://shipsgo.com/ocean) - Main hub for real-time ocean container tracking services.
- [Carriers Directory](https://shipsgo.com/ocean/carriers) - Directory listing 160+ supported ocean shipping lines.
- [Carrier Tracking](https://shipsgo.com/ocean/carriers/:carrier/container-tracking) - Dedicated tracking interface filtered for a specific ocean carrier.
- [Prefixes Directory](https://shipsgo.com/ocean/container-prefixes) - Master list of container prefixes to identify carrier/owner.
- [Prefix Tracking](https://shipsgo.com/ocean/container-prefixes/:prefix/container-tracking) - Dedicated tracking interface for containers starting with a specific prefix.
- [Ports Directory](https://shipsgo.com/ocean/ports) - Global directory of international ocean container ports and UN/LOCODEs.
- [Port Details](https://shipsgo.com/ocean/ports/:code) - Specific location, coordinates, and details for a single ocean port.
- [Specific Country Ports](https://shipsgo.com/ocean/ports/countries/:country) - A comprehensive list of all ocean ports located within a specific country.
- [Ocean API](https://shipsgo.com/ocean/container-tracking-api) - REST API documentation for automating ocean container tracking.
- [ETA Prediction](https://shipsgo.com/ocean/eta-prediction) - Information on machine-learning-based, highly accurate ocean arrival predictions.

### Air Routes (`/air`)

**Dynamic Parameters:**
* `:airline` - Lowercase airline slug (e.g., `turkish-cargo`, `emirates`)
* `:iata` - 3-letter IATA code (e.g., `ist`, `jfk`)
* `:country` - Lowercase country slug (e.g., `united-states-usa`, `germany`)

- [Air Index](https://shipsgo.com/air) - Main hub for real-time air cargo tracking services.
- [Airlines Directory](https://shipsgo.com/air/airlines) - Directory listing 160+ supported international airlines.
- [Airline Tracking](https://shipsgo.com/air/airlines/:airline/cargo-tracking) - Dedicated tracking interface filtered for a specific airline.
- [Airports Directory](https://shipsgo.com/air/airports) - Global directory of international airports and their IATA codes.
- [Airport Details](https://shipsgo.com/air/airports/:iata) - Specific location and details for a single airport based on its IATA code.
- [Specific Country Airports](https://shipsgo.com/air/airports/countries/:country) - A comprehensive list of all airports located within a specific country.
- [Air API](https://shipsgo.com/air/cargo-tracking-api) - REST API documentation for automating air cargo tracking via AWB.

### Additional Hubs

- [Sustainability Index](https://shipsgo.com/sustainability) - Overview of services to track CO2 emissions and offset carbon footprints.
- [CO2 Methodology](https://shipsgo.com/sustainability/co2-methodology) - Explanation of how ShipsGo calculates shipment CO2 emissions using industry standards.