HarborCosts API
REST API for port cost calculations — estimate, compare and query port charges with itemized breakdowns powered by Arkiway's tariff intelligence engine.
Port cost intelligence via API
The HarborCosts API exposes Arkiway's port cost calculation engine as a commercial REST service. Submit vessel parameters and port identifiers to receive detailed cost breakdowns — harbour dues, pilotage, quay fees, towage and ancillary charges — all computed from structured tariff data.
Designed for system-to-system integrations, the API supports cost estimation, multi-port comparison and tariff data retrieval with predictable versioning and comprehensive error handling.
- OAuth 2.0 Client Credentials flow
- JWT bearer tokens with configurable scopes
- Rate limiting with clear headers and retry guidance
- Versioned endpoints with backwards compatibility
API capability groups
Core capabilities available through the HarborCosts API.
Calculate detailed port cost breakdowns for any vessel and cargo combination across supported ports.
- Per-port cost projections with itemised fee breakdown
- Support for all major vessel types and cargo classifications
- Current and historical tariff-based calculations
- Multi-scenario estimation for voyage planning
Compare costs across alternative ports on a route to identify the most cost-effective options.
- Side-by-side cost comparison across ports
- Route-based port optimisation suggestions
- Cost ranking by vessel type and cargo category
- Regional and corridor-level cost benchmarking
Cross-reference actual port invoices against calculated baselines for mandatory fees to detect discrepancies.
- Calculated baselines for mandatory port fees
- Deviation detection against expected cost ranges
- Historical invoice trend tracking per port
- Exportable verification reports for finance teams
Feed structured port cost data into ERP and financial systems for reporting and budgeting.
- Structured cost data for ERP integration
- Budget forecasting based on planned voyages
- Accrual calculations for port cost provisions
- Fleet-level cost analytics and trend reporting
Integrate port cost intelligence
The HarborCosts API is available through commercial agreements. Contact our team to discuss access, pricing and technical onboarding for your integration.