Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

AISStream AIS Stream API

Real-time global AIS vessel-tracking stream delivered over a single WebSocket at "wss://stream.aisstream.io/v0/stream". The client connects, sends a JSON subscription message (APIKey plus BoundingBoxes and optional FiltersShipMMSI and FilterMessageTypes), and receives a continuous feed of AIS messages - each an envelope with MessageType, a free-form MetaData object, and the decoded Message keyed by its type (PositionReport, ShipStaticData, and the rest of the ITU-R M.1371 message set).

AISStream AIS Stream API is published by AISStream on the APIs.io network, described by an AsyncAPI event-driven specification.

Tagged areas include AIS, Vessel Tracking, WebSocket, Streaming, and Real-Time Data. The published artifact set on APIs.io includes API documentation, an API reference, an AsyncAPI specification, and SDKs.

This event API exposes 2 operations across 1 channel, and defines 7 schemas. It is described by AsyncAPI 2.6.0, at version 1.0.0.

The API connects through a single server, stream.aisstream.io/v0/stream (wss).

2 operations 1 channels 7 schemas

Metadata

The identity and technical contract details declared by the specification.

Specification
AsyncAPI 2.6.0
API Version
1.0.0
Base URL
wss://stream.aisstream.io/v0/stream
Resource Areas
1

Channels & Operations 2

Across 1 channel, the API surfaces 2 operations. Each is listed below with its action, channel, parameters, and response codes.

Channels 2
SUB
/v0/stream
Receive the stream of AIS messages (server to client).
receiveAisMessages body
PUB
/v0/stream
Send the subscription message (client to server).
sendSubscription body

Messages & Schemas 7

The contract defines 7 schemas that model the data carried by its messages. The most detailed are PositionReport (17 properties), ShipStaticData (16 properties), SubscriptionMessage (4 properties), AisStreamMessage (3 properties). Each schema is shown below with its type and property counts.

SubscriptionMessage
message
The JSON message the client sends to open or update a subscription.
AisStreamMessage
message
A single decoded AIS message wrapped in the AISStream envelope.
SubscriptionMessage
object
Client subscription request. Grounded in github.com/aisstream/ais-message-models SubscriptionMessage.
4 properties 2 required
AisStreamMessage
object
The envelope wrapping every AIS message pushed by the server.
3 properties 3 required
AisMessageType
string
The set of AIS message types AISStream can stream, from github.com/aisstream/ais-message-models AisMessageTypes.
PositionReport
object
Decoded AIS Position Report (ITU-R M.1371 message types 1/2/3). Fields from github.com/aisstream/ais-message-models PositionReport.
17 properties
ShipStaticData
object
Decoded AIS Ship Static and Voyage Related Data (message type 5). Fields from github.com/aisstream/ais-message-models ShipStaticData.
16 properties

Specification

The full machine-readable AsyncAPI contract behind this narrative.

Source

aisstream-asyncapi.yml Raw ↑