Call the charge tables instead of maintaining them

Authentication

Pass your key as a bearer token. Keys are per-org and issued from your account. The raw key is shown once, at creation; Wharfa stores only its hash.

curl https://api.wharfa.com/v1/charges/current?type=IMP_DETENTION&publisher=msc&port=AUMEL \
  -H "Authorization: Bearer whk_your_key_here"

Rate limits

Requests are rate-limited per key on a sliding one-minute window (default 600/min). Over the limit returns 429 with a Retry-After header. Public, unkeyed reads are cacheable and not limited, but return the 14-day-delayed change feed.

All tracked publishers (carriers, stevedores, parks).

Current free-time rule for a line at a port.

Current tariff (rate_schedule, verify_status, source).

Comparison table for detention or TAC.

Terminal access charges at a port.

What a value was on a past date, with snapshot_url.

Change feed. Free is delayed 14 days; keyed is undelayed.

Upcoming effective dates (undelayed public facts).

Tiered detention estimate with source lineage.

Fixed landside pass-through (TAC + ECP + VBS).

Latest Wharfa Landside Index value.

Index history by quarter.

The public source register.

Freshness and overdue sources.

Issue a key (raw key returned once).

Revoke a key.

Webhooks

Register an endpoint to receive change events as they are detected (undelayed, for keyed callers). Payloads carry the publisher, the old and new value, the effective date and the source snapshot. Retries are signed; verify the signature before acting.

Versioning & attribution

The surface is versioned under /v1. Breaking changes are announced 90 days ahead; we know what depending on a reference feels like. End-user interfaces must carry the attribution "Charge data by Wharfa". Full terms of use, including data handling on termination, are in the API Licence Terms; white-label arrangements are available under a separate enterprise agreement.

Questions: [email protected]