VesselMetadataJsonV1

Vessel metadata model

TransportationOpen DataGovernmentTrafficRailwaysMaritimeRoadsFinlandReal-Time

Properties

Name	Type	Description
name	string	Name of the vessel, maximum 20 characters using 6-bit ASCII
timestamp	integer	Record timestamp in milliseconds from Unix epoch
shipType	integer	Vessel's AIS ship type
mmsi	integer	Maritime Mobile Service Identity
draught	integer	Maximum present static draught in 1/10m, 255 = draught 25.5 m or greater, 0 = not available (default)
imo	integer	Vessel International Maritime Organization (IMO) number
callSign	string	Call sign, maximum 7 6-bit ASCII characters
eta	integer	Estimated time of arrival; MMDDHHMM UTC Bits 19-16: month; 1-12; 0 = not available = default Bits 15-11: day; 1-31; 0 = not available = default Bits 10-6: hour; 0-23; 24 = not available = default Bits
posType	integer	Type of electronic position fixing device: 0 = undefined (default) 1 = GPS 2 = GLONASS 3 = combined GPS/GLONASS 4 = Loran-C 5 = Chayka 6 = integrated navigation system 7 = surveyed 8 = Galileo, 9-14 =
referencePointA	integer	Reference point for reported position dimension A
referencePointB	integer	Reference point for reported position dimension B
referencePointC	integer	Reference point for reported position dimension C
referencePointD	integer	Reference point for reported position dimension D
destination	string	Destination, maximum 20 characters using 6-bit ASCII

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/digitraffic-fi/json-schema/digitraffic-fi-vessel-metadata-json-v1-schema.json",
  "title": "VesselMetadataJsonV1",
  "description": "Vessel metadata model",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/digitraffic-fi-marine-api-openapi.yml#/components/schemas/VesselMetadataJsonV1",
  "required": [
    "callSign",
    "destination",
    "draught",
    "eta",
    "imo",
    "mmsi",
    "name",
    "posType",
    "referencePointA",
    "referencePointB",
    "referencePointC",
    "referencePointD",
    "shipType",
    "timestamp"
  ],
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the vessel, maximum 20 characters using 6-bit ASCII"
    },
    "timestamp": {
      "type": "integer",
      "description": "Record timestamp in milliseconds from Unix epoch",
      "format": "int64"
    },
    "shipType": {
      "maximum": 255,
      "minimum": 0,
      "type": "integer",
      "description": "Vessel's AIS ship type",
      "format": "int32"
    },
    "mmsi": {
      "type": "integer",
      "description": "Maritime Mobile Service Identity",
      "format": "int32"
    },
    "draught": {
      "maximum": 255,
      "minimum": 0,
      "type": "integer",
      "description": "Maximum present static draught in 1/10m, 255 = draught 25.5 m or greater, 0 = not available (default)",
      "format": "int32"
    },
    "imo": {
      "type": "integer",
      "description": "Vessel International Maritime Organization (IMO) number",
      "format": "int32"
    },
    "callSign": {
      "type": "string",
      "description": "Call sign, maximum 7 6-bit ASCII characters"
    },
    "eta": {
      "type": "integer",
      "description": "Estimated time of arrival; MMDDHHMM UTC\nBits 19-16: month; 1-12; 0 = not available = default\nBits 15-11: day; 1-31; 0 = not available = default\nBits 10-6: hour; 0-23; 24 = not available = default\nBits 5-0: minute; 0-59; 60 = not available = default\nFor SAR aircraft, the use of this field may be decided by the responsible administration",
      "format": "int64"
    },
    "posType": {
      "maximum": 15,
      "minimum": 0,
      "type": "integer",
      "description": "Type of electronic position fixing device: 0 = undefined (default)\n1 = GPS\n2 = GLONASS\n3 = combined GPS/GLONASS\n4 = Loran-C\n5 = Chayka\n6 = integrated navigation system\n7 = surveyed\n8 = Galileo,\n9-14 = not used\n15 = internal GNSS",
      "format": "int32"
    },
    "referencePointA": {
      "type": "integer",
      "description": "Reference point for reported position dimension A",
      "format": "int64"
    },
    "referencePointB": {
      "type": "integer",
      "description": "Reference point for reported position dimension B",
      "format": "int64"
    },
    "referencePointC": {
      "type": "integer",
      "description": "Reference point for reported position dimension C",
      "format": "int64"
    },
    "referencePointD": {
      "type": "integer",
      "description": "Reference point for reported position dimension D",
      "format": "int64"
    },
    "destination": {
      "type": "string",
      "description": "Destination, maximum 20 characters using 6-bit ASCII"
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this

find_json_schemasBrowse and filter every JSON Schema in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This JSON Schema

curl "https://apis.io/api/v1/json-schemas/digitraffic-fi-vessel-metadata-json-v1"

All schemas

curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.