VesselFinder website screenshot

VesselFinder

VesselFinder is a maritime intelligence company operating a global AIS vessel-tracking network (terrestrial AIS plus satellite AIS) and offering ship positions, voyage history, vessel particulars, port-call events, sea-distance routing, and ocean-container track-and-trace through its developer APIs. The platform pairs a credit-metered AIS REST API (Vessels, PortCalls, ExpectedArrivals, MasterData, Distance, plus subscription feeds VesselsList and LiveData) with a separate Container Tracking API that returns shipment schedules and real-time vessel positions by container number. VesselFinder also runs a public web map, iOS/Android apps, an embeddable map widget, a fleet explorer, and a route planner.

VesselFinder publishes 10 APIs on the APIs.io network, including Containers API, Distance API, Expected Arrivals API, and 7 more. Tagged areas include AIS, Maritime, Vessel Tracking, Container Tracking, and Geospatial.

The VesselFinder catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

VesselFinder’s developer surface includes authentication, developer portal, documentation, getting-started guide, pricing, FAQ, support, and 25 more developer resources.

59.5/100 strong ▬ flat Agent 31/100 agent aware Full breakdown ↓
scored 2026-08-05 · rubric v0.9.1
AccessPaidSelf serve
10 APIs 16 Features
AISMaritimeVessel TrackingContainer TrackingGeospatialLogisticsPortsSupply Chain

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-05 · rubric v0.9.1
Composite quality — 59.5/100 · strong
Contract Quality 18.6 / 25
Developer Ergonomics 11.3 / 20
Commercial Clarity 14.2 / 20
Operational Transparency 0.7 / 13
Governance 8.3 / 12
Discoverability 6.5 / 10
Agent readiness — 31/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/vesselfinder: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 10

Individual APIs this provider publishes, each with its own machine-readable definition.

VesselFinder Containers API

Real-time container track-and-trace.

VesselFinder Distance API

Sea-route distance and geometry between two points.

VesselFinder Expected Arrivals API

Vessels with announced ETAs at a selected port.

VesselFinder List Manager API

Manage the watchlist of vessels backing the VesselsList method.

VesselFinder Live Data API

All vessels within a predefined geographic area, subscription-based.

VesselFinder Master Data API

Static vessel particulars by IMO.

VesselFinder Port Calls API

Arrival and departure events for vessels or ports.

VesselFinder Status API

Account status and remaining credits.

VesselFinder Vessels API

On-demand vessel position, voyage, and master data lookups.

VesselFinder Vessels List API

Predefined-fleet data, subscription-based.

Scroll for all 10

Postman Collections 10

Ready-to-run Postman collections for exercising this provider's APIs.

Scroll for all 10

Open Collections 2

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

VesselFinder AIS API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Rate Limits 1

Documented rate limits and quota policies.

Vesselfinder Rate Limits

0 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Features 16

Notable capabilities this provider offers.

Global AIS vessel tracking network — terrestrial receivers plus satellite AIS coverage
On-demand REST endpoints for vessel positions (Vessels), port arrivals/departures (PortCalls), and expected arrivals (ExpectedArrivals)
Static vessel particulars (MasterData) including flag, type, dimensions, tonnage, TEU, deadweight
Three dataset families — AIS (dynamic), Voyage (last port call), Master (static particulars)
Sea-route distance and routing API with optional canal/strait gateway preferences and ECA handling
Subscription feeds — VesselsList for a predefined fleet, LiveData for a predefined rectangular area
Fleet watchlist management via ListManager (GET, POST, PUT, DELETE)
Container Tracking API — track ocean-freight containers by container number with optional SCAC carrier
Asynchronous container lookups with 202 polling and 12-hour caching
Credit-metered AIS billing (terrestrial 1 credit, satellite 10 credits, master 2–3 credits, distance 1 credit)
Prepaid AIS credit packs (10k / 20k / 50k) priced in EUR; container subscriptions priced in USD
JSON (default) and XML response formats
API key authentication via the userkey query parameter
Reference taxonomies — Flag Codes, AIS Ship Types, AIS NavStat
Official PHP and Python wrapper libraries on GitHub for both AIS and Container Tracking APIs
VesselFinder web platform, iOS/Android apps, embeddable maps, fleet explorer, and route planner

Scroll for all 16

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Vesselfinder Context

0 classes · 6 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

VesselFinder API Rules

6 rules · 4 warnings 2 info

SPECTRAL

VesselFinder API Rules

9 rules · 6 errors 3 warnings

SPECTRAL

JSON Schema 3

Standalone JSON Schema definitions for this provider's data models.

VesselFinder Container Shipment

3 properties

JSON SCHEMA

VesselFinder Port Call

7 properties

JSON SCHEMA

VesselFinder Vessel

3 properties

JSON SCHEMA

JSON Structure 1

JSON Structure definitions describing this provider's data shapes.

Vesselfinder Vessel Structure

0 properties

JSON STRUCTURE

Examples 3

Example request and response payloads for these APIs.

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Vesselfinder Authentication

apiKey · 2 schemes

SECURITY

Vesselfinder Domain Security

TLSv1.3 · HSTS

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Vesselfinder Agentic Access

13 operations · 3 acting

13 operations · 3 acting

AGENTIC

Resources

Get Started 2

Portal, sign-up, and the first successful call

Documentation 6

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 2

Pagination, idempotency, versioning, errors, and events

Build 5

SDKs, sample code, and the tooling you integrate with

Access & Security 2

Authentication, authorization, and security posture

Learn 1

Tutorials, courses, talks, and written guidance

Operate 3

Status, limits, changes, and where to get help

Commercial 5

Pricing, plans, and the legal terms of use

Company 3

The organization behind the API

Other 2

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
aid: vesselfinder
url: https://raw.githubusercontent.com/api-evangelist/vesselfinder/refs/heads/main/apis.yml
apis:
- aid: vesselfinder:vesselfinder-containers-api
  name: VesselFinder Containers API
  description: Real-time container track-and-trace.
  humanURL: https://api.vesselfinder.com/docs/
  tags:
  - Containers
  properties:
  - type: OpenAPI
    url: openapi/vesselfinder-containers-api-openapi.yml
  - type: Documentation
    url: https://api.vesselfinder.com/docs/
  - type: Documentation
    url: https://api.vesselfinder.com/docs/vessels.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/portcalls.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/expectedarrivals.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/masterdata.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/distance.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/vesselslist.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/livedata.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/status.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/listmanager.html
  - type: JSONSchema
    url: json-schema/vesselfinder-vessel-schema.json
  - type: JSONSchema
    url: json-schema/vesselfinder-port-call-schema.json
  - type: JSONStructure
    url: json-structure/vesselfinder-vessel-structure.json
  - type: JSONLD
    url: json-ld/vesselfinder-context.jsonld
  - type: Documentation
    url: https://container.vesselfinder.com/api/1.0/docs
  - type: Documentation
    url: https://www.vesselfinder.com/container-tracking
  - type: JSONSchema
    url: json-schema/vesselfinder-container-shipment-schema.json
- aid: vesselfinder:vesselfinder-distance-api
  name: VesselFinder Distance API
  description: Sea-route distance and geometry between two points.
  humanURL: https://api.vesselfinder.com/docs/
  tags:
  - Distance
  properties:
  - type: OpenAPI
    url: openapi/vesselfinder-distance-api-openapi.yml
  - type: Documentation
    url: https://api.vesselfinder.com/docs/
  - type: Documentation
    url: https://api.vesselfinder.com/docs/vessels.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/portcalls.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/expectedarrivals.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/masterdata.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/distance.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/vesselslist.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/livedata.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/status.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/listmanager.html
  - type: JSONSchema
    url: json-schema/vesselfinder-vessel-schema.json
  - type: JSONSchema
    url: json-schema/vesselfinder-port-call-schema.json
  - type: JSONStructure
    url: json-structure/vesselfinder-vessel-structure.json
  - type: JSONLD
    url: json-ld/vesselfinder-context.jsonld
  - type: Documentation
    url: https://container.vesselfinder.com/api/1.0/docs
  - type: Documentation
    url: https://www.vesselfinder.com/container-tracking
  - type: JSONSchema
    url: json-schema/vesselfinder-container-shipment-schema.json
- aid: vesselfinder:vesselfinder-expected-arrivals-api
  name: VesselFinder Expected Arrivals API
  description: Vessels with announced ETAs at a selected port.
  humanURL: https://api.vesselfinder.com/docs/
  tags:
  - Expected Arrivals
  properties:
  - type: OpenAPI
    url: openapi/vesselfinder-expected-arrivals-api-openapi.yml
  - type: Documentation
    url: https://api.vesselfinder.com/docs/
  - type: Documentation
    url: https://api.vesselfinder.com/docs/vessels.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/portcalls.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/expectedarrivals.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/masterdata.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/distance.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/vesselslist.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/livedata.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/status.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/listmanager.html
  - type: JSONSchema
    url: json-schema/vesselfinder-vessel-schema.json
  - type: JSONSchema
    url: json-schema/vesselfinder-port-call-schema.json
  - type: JSONStructure
    url: json-structure/vesselfinder-vessel-structure.json
  - type: JSONLD
    url: json-ld/vesselfinder-context.jsonld
  - type: Documentation
    url: https://container.vesselfinder.com/api/1.0/docs
  - type: Documentation
    url: https://www.vesselfinder.com/container-tracking
  - type: JSONSchema
    url: json-schema/vesselfinder-container-shipment-schema.json
- aid: vesselfinder:vesselfinder-list-manager-api
  name: VesselFinder List Manager API
  description: Manage the watchlist of vessels backing the VesselsList method.
  humanURL: https://api.vesselfinder.com/docs/
  tags:
  - List Manager
  properties:
  - type: OpenAPI
    url: openapi/vesselfinder-list-manager-api-openapi.yml
  - type: Documentation
    url: https://api.vesselfinder.com/docs/
  - type: Documentation
    url: https://api.vesselfinder.com/docs/vessels.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/portcalls.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/expectedarrivals.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/masterdata.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/distance.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/vesselslist.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/livedata.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/status.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/listmanager.html
  - type: JSONSchema
    url: json-schema/vesselfinder-vessel-schema.json
  - type: JSONSchema
    url: json-schema/vesselfinder-port-call-schema.json
  - type: JSONStructure
    url: json-structure/vesselfinder-vessel-structure.json
  - type: JSONLD
    url: json-ld/vesselfinder-context.jsonld
  - type: Documentation
    url: https://container.vesselfinder.com/api/1.0/docs
  - type: Documentation
    url: https://www.vesselfinder.com/container-tracking
  - type: JSONSchema
    url: json-schema/vesselfinder-container-shipment-schema.json
- aid: vesselfinder:vesselfinder-live-data-api
  name: VesselFinder Live Data API
  description: All vessels within a predefined geographic area, subscription-based.
  humanURL: https://api.vesselfinder.com/docs/
  tags:
  - Live Data
  properties:
  - type: OpenAPI
    url: openapi/vesselfinder-live-data-api-openapi.yml
  - type: Documentation
    url: https://api.vesselfinder.com/docs/
  - type: Documentation
    url: https://api.vesselfinder.com/docs/vessels.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/portcalls.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/expectedarrivals.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/masterdata.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/distance.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/vesselslist.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/livedata.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/status.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/listmanager.html
  - type: JSONSchema
    url: json-schema/vesselfinder-vessel-schema.json
  - type: JSONSchema
    url: json-schema/vesselfinder-port-call-schema.json
  - type: JSONStructure
    url: json-structure/vesselfinder-vessel-structure.json
  - type: JSONLD
    url: json-ld/vesselfinder-context.jsonld
  - type: Documentation
    url: https://container.vesselfinder.com/api/1.0/docs
  - type: Documentation
    url: https://www.vesselfinder.com/container-tracking
  - type: JSONSchema
    url: json-schema/vesselfinder-container-shipment-schema.json
- aid: vesselfinder:vesselfinder-master-data-api
  name: VesselFinder Master Data API
  description: Static vessel particulars by IMO.
  humanURL: https://api.vesselfinder.com/docs/
  tags:
  - Master Data
  properties:
  - type: OpenAPI
    url: openapi/vesselfinder-master-data-api-openapi.yml
  - type: Documentation
    url: https://api.vesselfinder.com/docs/
  - type: Documentation
    url: https://api.vesselfinder.com/docs/vessels.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/portcalls.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/expectedarrivals.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/masterdata.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/distance.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/vesselslist.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/livedata.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/status.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/listmanager.html
  - type: JSONSchema
    url: json-schema/vesselfinder-vessel-schema.json
  - type: JSONSchema
    url: json-schema/vesselfinder-port-call-schema.json
  - type: JSONStructure
    url: json-structure/vesselfinder-vessel-structure.json
  - type: JSONLD
    url: json-ld/vesselfinder-context.jsonld
  - type: Documentation
    url: https://container.vesselfinder.com/api/1.0/docs
  - type: Documentation
    url: https://www.vesselfinder.com/container-tracking
  - type: JSONSchema
    url: json-schema/vesselfinder-container-shipment-schema.json
- aid: vesselfinder:vesselfinder-port-calls-api
  name: VesselFinder Port Calls API
  description: Arrival and departure events for vessels or ports.
  humanURL: https://api.vesselfinder.com/docs/
  tags:
  - Port Calls
  properties:
  - type: OpenAPI
    url: openapi/vesselfinder-port-calls-api-openapi.yml
  - type: Documentation
    url: https://api.vesselfinder.com/docs/
  - type: Documentation
    url: https://api.vesselfinder.com/docs/vessels.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/portcalls.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/expectedarrivals.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/masterdata.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/distance.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/vesselslist.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/livedata.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/status.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/listmanager.html
  - type: JSONSchema
    url: json-schema/vesselfinder-vessel-schema.json
  - type: JSONSchema
    url: json-schema/vesselfinder-port-call-schema.json
  - type: JSONStructure
    url: json-structure/vesselfinder-vessel-structure.json
  - type: JSONLD
    url: json-ld/vesselfinder-context.jsonld
  - type: Documentation
    url: https://container.vesselfinder.com/api/1.0/docs
  - type: Documentation
    url: https://www.vesselfinder.com/container-tracking
  - type: JSONSchema
    url: json-schema/vesselfinder-container-shipment-schema.json
- aid: vesselfinder:vesselfinder-status-api
  name: VesselFinder Status API
  description: Account status and remaining credits.
  humanURL: https://api.vesselfinder.com/docs/
  tags:
  - Status
  properties:
  - type: OpenAPI
    url: openapi/vesselfinder-status-api-openapi.yml
  - type: Documentation
    url: https://api.vesselfinder.com/docs/
  - type: Documentation
    url: https://api.vesselfinder.com/docs/vessels.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/portcalls.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/expectedarrivals.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/masterdata.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/distance.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/vesselslist.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/livedata.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/status.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/listmanager.html
  - type: JSONSchema
    url: json-schema/vesselfinder-vessel-schema.json
  - type: JSONSchema
    url: json-schema/vesselfinder-port-call-schema.json
  - type: JSONStructure
    url: json-structure/vesselfinder-vessel-structure.json
  - type: JSONLD
    url: json-ld/vesselfinder-context.jsonld
  - type: Documentation
    url: https://container.vesselfinder.com/api/1.0/docs
  - type: Documentation
    url: https://www.vesselfinder.com/container-tracking
  - type: JSONSchema
    url: json-schema/vesselfinder-container-shipment-schema.json
- aid: vesselfinder:vesselfinder-vessels-api
  name: VesselFinder Vessels API
  description: On-demand vessel position, voyage, and master data lookups.
  humanURL: https://api.vesselfinder.com/docs/
  tags:
  - Vessels
  properties:
  - type: OpenAPI
    url: openapi/vesselfinder-vessels-api-openapi.yml
  - type: Documentation
    url: https://api.vesselfinder.com/docs/
  - type: Documentation
    url: https://api.vesselfinder.com/docs/vessels.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/portcalls.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/expectedarrivals.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/masterdata.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/distance.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/vesselslist.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/livedata.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/status.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/listmanager.html
  - type: JSONSchema
    url: json-schema/vesselfinder-vessel-schema.json
  - type: JSONSchema
    url: json-schema/vesselfinder-port-call-schema.json
  - type: JSONStructure
    url: json-structure/vesselfinder-vessel-structure.json
  - type: JSONLD
    url: json-ld/vesselfinder-context.jsonld
  - type: Documentation
    url: https://container.vesselfinder.com/api/1.0/docs
  - type: Documentation
    url: https://www.vesselfinder.com/container-tracking
  - type: JSONSchema
    url: json-schema/vesselfinder-container-shipment-schema.json
- aid: vesselfinder:vesselfinder-vessels-list-api
  name: VesselFinder Vessels List API
  description: Predefined-fleet data, subscription-based.
  humanURL: https://api.vesselfinder.com/docs/
  tags:
  - Vessels List
  properties:
  - type: OpenAPI
    url: openapi/vesselfinder-vessels-list-api-openapi.yml
  - type: Documentation
    url: https://api.vesselfinder.com/docs/
  - type: Documentation
    url: https://api.vesselfinder.com/docs/vessels.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/portcalls.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/expectedarrivals.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/masterdata.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/distance.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/vesselslist.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/livedata.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/status.html
  - type: Documentation
    url: https://api.vesselfinder.com/docs/listmanager.html
  - type: JSONSchema
    url: json-schema/vesselfinder-vessel-schema.json
  - type: JSONSchema
    url: json-schema/vesselfinder-port-call-schema.json
  - type: JSONStructure
    url: json-structure/vesselfinder-vessel-structure.json
  - type: JSONLD
    url: json-ld/vesselfinder-context.jsonld
  - type: Documentation
    url: https://container.vesselfinder.com/api/1.0/docs
  - type: Documentation
    url: https://www.vesselfinder.com/container-tracking
  - type: JSONSchema
    url: json-schema/vesselfinder-container-shipment-schema.json
name: VesselFinder
tags:
- AIS
- Maritime
- Vessel Tracking
- Container Tracking
- Geospatial
- Logistics
- Ports
- Supply Chain
kind: contract
accessModel:
  pricing: paid
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Paid · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/vesselfinder.png
access: 3rd-Party
common:
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/vesselfinder/overview
- type: AgenticAccess
  url: agentic-access/vesselfinder-agentic-access.yml
- type: DomainSecurity
  url: security/vesselfinder-domain-security.yml
- type: Authentication
  url: authentication/vesselfinder-authentication.yml
- type: Portal
  url: https://www.vesselfinder.com
- type: Documentation
  url: https://api.vesselfinder.com/docs/
- type: Documentation
  url: https://container.vesselfinder.com/api/1.0/docs
- type: GettingStarted
  url: https://api.vesselfinder.com/docs/
- url: https://www.vesselfinder.com/api
  type: Pricing
  data:
  - id: ais-credits-10k
    name: AIS Credits — 10,000
    entries:
    - geo: global
      unit: 10000
      label: Credits
      limit: 10000
      price: 330
      metric: credit
      timeFrame: 12-months
      description: 10,000 AIS API credits. Expire 12 months after purchase. EUR.
    description: 10k credits AIS pack.
  - id: ais-credits-20k
    name: AIS Credits — 20,000
    entries:
    - geo: global
      unit: 20000
      label: Credits
      limit: 20000
      price: 625
      metric: credit
      timeFrame: 12-months
      description: 20,000 AIS API credits. Expire 12 months after purchase. EUR.
    description: 20k credits AIS pack.
  - id: ais-credits-50k
    name: AIS Credits — 50,000
    entries:
    - geo: global
      unit: 50000
      label: Credits
      limit: 50000
      price: 1470
      metric: credit
      timeFrame: 12-months
      description: 50,000 AIS API credits. Expire 12 months after purchase. EUR.
    description: 50k credits AIS pack.
  - id: container-tracking-1
    name: Container Tracking — 1
    entries:
    - geo: global
      unit: 1
      label: Container
      limit: 1
      price: 7
      metric: container
      timeFrame: 12-months
      description: 1 container subscription. USD, VAT excluded.
    description: Single container subscription.
  - id: container-tracking-10
    name: Container Tracking — 10
    entries:
    - geo: global
      unit: 10
      label: Containers
      limit: 10
      price: 65
      metric: container
      timeFrame: 12-months
      description: 10 containers. USD, VAT excluded.
    description: 10 container subscription.
  - id: container-tracking-20
    name: Container Tracking — 20
    entries:
    - geo: global
      unit: 20
      label: Containers
      limit: 20
      price: 120
      metric: container
      timeFrame: 12-months
      description: 20 containers. USD, VAT excluded.
    description: 20 container subscription.
  - id: container-tracking-50
    name: Container Tracking — 50
    entries:
    - geo: global
      unit: 50
      label: Containers
      limit: 50
      price: 275
      metric: container
      timeFrame: 12-months
      description: 50 containers. USD, VAT excluded.
    description: 50 container subscription.
  - id: container-tracking-100
    name: Container Tracking — 100
    entries:
    - geo: global
      unit: 100
      label: Containers
      limit: 100
      price: 500
      metric: container
      timeFrame: 12-months
      description: 100 containers. USD, VAT excluded.
    description: 100 container subscription.
  - id: vesselslist-subscription
    name: VesselsList (Fleet) Subscription
    entries:
    - geo: global
      unit: 1
      label: Subscription
      limit: -1
      price: Call
      metric: vessel
      timeFrame: month
      description: Fleet subscription, priced by fleet size and dataset selection.
    description: Predefined fleet subscription.
  - id: livedata-subscription
    name: LiveData (Area) Subscription
    entries:
    - geo: global
      unit: 1
      label: Subscription
      limit: -1
      price: Call
      metric: area
      timeFrame: month
      description: Area subscription, priced by area, traffic, and dataset selection.
    description: Predefined area subscription.
  name: Pricing
- url: https://api.vesselfinder.com/docs/
  name: Implementation
  type: Documentation
- url: https://api.vesselfinder.com/docs/
  name: FAQ
  type: FAQ
- url: https://api.vesselfinder.com/docs/flags.html
  name: Flag Codes
  type: Documentation
- url: https://api.vesselfinder.com/docs/aistypes.html
  name: AIS Ship Types
  type: Documentation
- url: https://api.vesselfinder.com/docs/navstat.html
  name: AIS NavStat Codes
  type: Documentation
- url: https://www.vesselfinder.com/contact
  type: Support
- url: https://www.vesselfinder.com/terms
  type: TermsOfService
- url: https://www.vesselfinder.com/privacy
  type: PrivacyPolicy
- url: https://route.vesselfinder.com
  name: Route Planner
  type: Tools
- url: https://www.vesselfinder.com/news
  type: Blog
- url: https://twitter.com/VesselFinder
  type: Twitter
- url: https://www.facebook.com/vesselfinder
  type: Facebook
- url: https://www.youtube.com/vesselfinder
  type: YouTube
- url: https://apps.apple.com/us/app/vesselfinder-lite/id918080862
  name: VesselFinder for iOS
  type: Application
- url: https://play.google.com/store/apps/details?id=com.astrapaging.vff
  name: VesselFinder for Android
  type: Application
- url: https://github.com/VesselFinder
  type: GitHubOrganization
- url: https://github.com/VesselFinder/vesselfinder-api-wrapper
  name: VesselFinder AIS API Wrapper (PHP, Python)
  type: SDKs
- url: https://github.com/VesselFinder/container-tracking-api-wrapper
  name: VesselFinder Container Tracking API Wrapper (PHP, Python)
  type: SDKs
- type: Plans
  url: plans/vesselfinder-plans-pricing.yml
- type: RateLimits
  url: rate-limits/vesselfinder-rate-limits.yml
- type: FinOps
  url: finops/vesselfinder-finops.yml
- type: Vocabulary
  url: vocabulary/vesselfinder-vocabulary.yml
- type: Spectral
  url: rules/vesselfinder-rules.yml
- type: Features
  data:
  - Global AIS vessel tracking network — terrestrial receivers plus satellite AIS coverage
  - On-demand REST endpoints for vessel positions (Vessels), port arrivals/departures (PortCalls), and expected arrivals (ExpectedArrivals)
  - Static vessel particulars (MasterData) including flag, type, dimensions, tonnage, TEU, deadweight
  - Three dataset families — AIS (dynamic), Voyage (last port call), Master (static particulars)
  - Sea-route distance and routing API with optional canal/strait gateway preferences and ECA handling
  - Subscription feeds — VesselsList for a predefined fleet, LiveData for a predefined rectangular area
  - Fleet watchlist management via ListManager (GET, POST, PUT, DELETE)
  - Container Tracking API — track ocean-freight containers by container number with optional SCAC carrier
  - Asynchronous container lookups with 202 polling and 12-hour caching
  - Credit-metered AIS billing (terrestrial 1 credit, satellite 10 credits, master 2–3 credits, distance 1 credit)
  - Prepaid AIS credit packs (10k / 20k / 50k) priced in EUR; container subscriptions priced in USD
  - JSON (default) and XML response formats
  - API key authentication via the userkey query parameter
  - Reference taxonomies — Flag Codes, AIS Ship Types, AIS NavStat
  - Official PHP and Python wrapper libraries on GitHub for both AIS and Container Tracking APIs
  - VesselFinder web platform, iOS/Android apps, embeddable maps, fleet explorer, and route planner
  sources:
  - https://api.vesselfinder.com/docs/
  - https://container.vesselfinder.com/api/1.0/docs
  - https://www.vesselfinder.com/api
  - https://github.com/VesselFinder
  updated: '2026-05-25'
created: '2026-05-25T00:00:00.000Z'
modified: '2026-05-25'
position: Consuming
description: 'VesselFinder is a maritime intelligence company operating a global AIS vessel-tracking network

  (terrestrial AIS plus satellite AIS) and offering ship positions, voyage history, vessel

  particulars, port-call events, sea-distance routing, and ocean-container track-and-trace through

  its developer APIs. The platform pairs a credit-metered AIS REST API (Vessels, PortCalls,

  ExpectedArrivals, MasterData, Distance, plus subscription feeds VesselsList and LiveData) with a

  separate Container Tracking API that returns shipment schedules and real-time vessel positions

  by container number. VesselFinder also runs a public web map, iOS/Android apps, an embeddable

  map widget, a fleet explorer, and a route planner.

  '
maintainers:
- FN: Kin Lane
  email: info@apievangelist.com
  X: apievangelist
  url: https://apievangelist.com
specificationVersion: '0.16'