war-tracker.com

{
  "properties": {
    "count": {
      "description": "Rows in this page (always ≤ 10).",
      "maximum": 10,
      "type": "integer"
    },
    "filters": {
      "description": "Echo of the active filter inputs.",
      "type": "object"
    },
    "has_more": {
      "type": "boolean"
    },
    "next_cursor": {
      "description": "Pass back as `?cursor=` to fetch the next page. Null when has_more=false.",
      "type": [
        "string",
        "null"
      ]
    },
    "vessels": {
      "items": {
        "properties": {
          "blacklist_updated_utc": {
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "bodies": {
            "description": "List of sanctioning bodies that have listed this vessel (one entry per body).",
            "items": {
              "properties": {
                "body": {
                  "enum": [
                    "ofac",
                    "fcdo",
                    "uani",
                    "eu",
                    "aso",
                    "gac",
                    "un",
                    "seco",
                    "mfat"
                  ],
                  "type": "string"
                },
                "listed_date": {
                  "description": "First-listed date (YYYY-MM-DD).",
                  "format": "date",
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "required": [
                "body"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "built": {
            "description": "Year built (blacklist source; may differ from year_built).",
            "type": [
              "integer",
              "null"
            ]
          },
          "class": {
            "description": "Blacklist size class (Handysize/Handymax, VLCC, …).",
            "type": [
              "string",
              "null"
            ]
          },
          "commercial_market_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "country_code": {
            "description": "ISO-3166-1 alpha-2 (AIS flag); null when vessel is not in our identity mirror.",
            "type": [
              "string",
              "null"
            ]
          },
          "flag_name": {
            "description": "Free-form flag name from the blacklist source (e.g. 'Iran').",
            "type": [
              "string",
              "null"
            ]
          },
          "imo": {
            "description": "7-digit IMO number (primary key for the blacklist row).",
            "type": "integer"
          },
          "last_cog": {
            "description": "Course over ground in degrees (0-360).",
            "type": [
              "number",
              "null"
            ]
          },
          "last_destination": {
            "description": "Free-form AIS destination string.",
            "type": [
              "string",
              "null"
            ]
          },
          "last_lat": {
            "maximum": 90,
            "minimum": -90,
            "type": [
              "number",
              "null"
            ]
          },
          "last_lon": {
            "maximum": 180,
            "minimum": -180,
            "type": [
              "number",
              "null"
            ]
          },
          "last_ping_utc": {
            "description": "Last AIS position timestamp; null when we have no position for the vessel.",
            "format": "date-time",
            "type": [
              "string",
              "null"
            ]
          },
          "last_pos_age_seconds": {
            "description": "Seconds elapsed between server clock and last_ping_utc.",
            "type": [
              "integer",
              "null"
            ]
          },
          "last_sog": {
            "description": "Speed over ground in knots.",
            "type": [
              "number",
              "null"
            ]
          },
          "length": {
            "description": "Overall length in metres.",
            "type": [
              "number",
              "null"
            ]
          },
          "mmsi": {
            "type": [
              "integer",
              "null"
            ]
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "ship_id": {
            "description": "MarineTraffic-internal vessel ID.",
            "type": [
              "string",
              "null"
            ]
          },
          "subtype": {
            "type": [
              "string",
              "null"
            ]
          },
          "type": {
            "type": [
              "string",
              "null"
            ]
          },
          "year_built": {
            "type": [
              "integer",
              "null"
            ]
          }
        },
        "required": [
          "imo",
          "bodies"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "vessels",
    "count",
    "has_more"
  ],
  "type": "object"
}