Get live network data

GET 
/vatsim-data.json

Returns the live data feed of the network. Re-generates every 15 seconds.

Request

Responses

200

Successful operation

application/json

Schema

Schema

general object

version integer

Major version of the data feed

reload integerdeprecated

Length of time (mins) to wait before reloading the data feed

update stringdeprecated

When the data feed was last generated

update_timestamp date-time

When the data feed was last generated

connected_clients integer

Total clients (pilots + controllers + ATIS) currently connected to the network

unique_users integer

Total unique users currently connected to the network

pilots object[]
Array [
cid integer
Pilot's VATSIM ID
name string
Pilot's full name
callsign string
Aircraft callsign
server string
Pilot's current server ident
pilot_rating integer
Pilot's pilot rating ID
military_rating integer
Pilot's military rating ID
latitude number
Aircraft latitude (deg)
longitude number
Aircraft longitude (deg)
altitude integer
Aircraft altitude (ft MSL)
groundspeed integer
Aircraft ground speed (kts)
transponder string
Aircraft transponder code
heading integer
Aircraft heading (deg. magnetic)
qnh_i_hg number
Aircraft QNH (inHg)
qnh_mb integer
Aircraft QNH (mbar)
flight_plan object
Pilot's flight plan, if filed
flight_rules string
Possible values: [I, V]
Whether this flight plan is IFR or VFR
aircraft string
ICAO aircraft type and equipment
aircraft_faa string
FAA aircraft type
aircraft_short string
ICAO aircraft type designator
departure string
Departure airport
arrival string
Arrival airport
alternate string
Alternate arrival airport
deptime string
Estimated off-block time
enroute_time string
Estimated time enroute
fuel_time string
Fuel endurance time
remarks string
Flight plan remarks
route string
Route of flight
revision_id integer
Flight plan revision ID
assigned_transponder string
System-assigned transponder code
logon_time date-time
When this pilot connected
last_updated date-time
When this pilot's status was last received
]
controllers object[]
Array [
cid integer
Controller's VATSIM ID
name string
Controller's full name
callsign string
Position callsign
frequency string
Position frequency (MHz)
facility integer
Position facility ID
rating integer
Controller's controller rating ID
server string
Controller's current server ident
visual_range integer
Position visual range (NM)
text_atis string[]
Controller information
last_updated date-time
When this controller's status was last received
logon_time date-time
When this controller connected
]
atis object[]
Array [
cid integer
Controller's VATSIM ID
name string
Controller's full name
callsign string
ATIS callsign
frequency string
ATIS frequency (MHz)
facility integer
ATIS facility ID
rating integer
Controller's controller rating ID
server string
Controller's current server ident
visual_range integer
ATIS visual range (NM)
atis_code string
Current ATIS phonetic letter
text_atis string[]
Text ATIS
last_updated date-time
When this ATIS's status was last received
logon_time date-time
When this ATIS connected
]
servers object[]
Array [
ident string
Server ident
hostname_or_ip string
Server hostname or IP address
location string
Human-readable geographical location of this server
name string
Human-readable name of this server
clients_connection_allowed integerdeprecated
Whether this server is accepting connections
client_connections_allowed boolean
Whether this server is accepting connections
is_sweatbox boolean
Whether this server is in sweatbox mode
]
prefiles object[]
Array [
cid integer
Pilot's VATSIM ID
name string
Pilot's VATSIM ID
callsign string
Prefile callsign
flight_plan object
flight_rules string
Possible values: [I, V]
Whether this flight plan is IFR or VFR
aircraft string
ICAO aircraft type and equipment
aircraft_faa string
FAA aircraft type
aircraft_short string
ICAO aircraft type designator
departure string
Departure airport
arrival string
Arrival airport
alternate string
Alternate arrival airport
deptime string
Estimated off-block time
enroute_time string
Estimated time enroute
fuel_time string
Fuel endurance time
remarks string
Flight plan remarks
route string
Route of flight
revision_id integer
Flight plan revision ID
assigned_transponder string
System-assigned transponder code
last_updated date-time
When this prefile's status was last received
]
facilities object[]
Array [
id integer
Facility ID
short string
Possible values: Value must match regular expression /[A-Z]{3}/
Short identifier
long_name string
Human-readable name
]
ratings object[]
Array [
id integer
Controller Rating ID
short_name string
Possible values: Value must match regular expression /[A-Z0-9]{2,4}/
Short identifier
long_name string
Human-readable name
]
pilot_ratings object[]
Array [
id integer
Pilot Rating ID
short_name string
Possible values: Value must match regular expression /[A-Z0-9]{2,4}/
Short identifier
long_name string
Human-readable name
]
military_ratings object[]
Array [
id integer
Military Rating ID
short_name string
Possible values: Value must match regular expression /[A-Z0-9]{2,4}/
Short identifier
long_name string
Human-readable name
]

Example (from schema)

{
  "general": {
    "version": 3,
    "update_timestamp": "1970-01-01T00:00:00.000000Z",
    "connected_clients": 0,
    "unique_users": 0
  },
  "pilots": [
    {
      "cid": 1234567,
      "name": "Kennedy Steve KJFK",
      "callsign": "DAL1",
      "server": "USA-EAST",
      "pilot_rating": 0,
      "military_rating": 0,
      "latitude": 40.64222,
      "longitude": -73.76981,
      "altitude": 12,
      "groundspeed": 0,
      "transponder": "3456",
      "heading": 44,
      "qnh_i_hg": 29.92,
      "qnh_mb": 1013,
      "flight_plan": {
        "flight_rules": "I",
        "aircraft": "B764/H-SDE3FGHIM3RWXY/LB1",
        "aircraft_faa": "B764/L",
        "aircraft_short": "B764",
        "departure": "KJFK",
        "arrival": "EGLL",
        "alternate": "EGBB",
        "deptime": "0000",
        "enroute_time": "0615",
        "fuel_time": "0745",
        "remarks": "/V/",
        "route": "GREKI DCT JUDDS DCT MARTN DCT BAREE DCT NEEKO NATX LIMRI NATX XETBO DCT EVRIN DCT INFEC DCT JETZI DCT OGLUN DCT OCTIZ P2 SIRIC SIRI1H",
        "revision_id": 1,
        "assigned_transponder": "3456"
      },
      "logon_time": "1970-01-01T00:00:00.000000Z",
      "last_updated": "1970-01-01T00:00:00.000000Z"
    }
  ],
  "controllers": [
    {
      "cid": 1234567,
      "name": "Kennedy Steve KJFK",
      "callsign": "JFK_GND",
      "frequency": "121.900",
      "facility": 0,
      "rating": 0,
      "server": "USA-EAST",
      "visual_range": 20,
      "text_atis": [
        "John F. Kennedy Ground (121.900)",
        "Online until 23:00z",
        "Feedback? nyartcc.org/feedback"
      ],
      "last_updated": "1970-01-01T00:00:00.000000Z",
      "logon_time": "1970-01-01T00:00:00.000000Z"
    }
  ],
  "atis": [
    {
      "cid": 1234567,
      "name": "Kennedy Steve KJFK",
      "callsign": "KJFK_ATIS",
      "frequency": "128.725",
      "facility": 0,
      "rating": 0,
      "server": "USA-EAST",
      "visual_range": 0,
      "atis_code": "A",
      "text_atis": [
        "KJFK ATIS INFO A 0000Z. 20004KT 10SM SCT013 BKN060 OVC082 22/20",
        "A2992 (TWO NINER NINER TWO). APCH IN USE ILS RY 22L, ILS 22R.",
        "DEPTG RY 22R... BIRD ACTIVITY VICINITY ARPT. NUM CRANES",
        "OPERATING AT JFK. OPERATE XPDR ON MODE *C ON ALL TAXIWAYS AND",
        "RUNWAYS. READBACK ALL RWY HOLD SHORT INSTRUCTIONS....ADVS YOU",
        "HAVE INFO A"
      ],
      "last_updated": "1970-01-01T00:00:00.000000Z",
      "logon_time": "1970-01-01T00:00:00.000000Z"
    }
  ],
  "servers": [
    {
      "ident": "USA-EAST",
      "hostname_or_ip": "192.0.2.10",
      "location": "New York, USA",
      "name": "USA-EAST",
      "client_connections_allowed": true,
      "is_sweatbox": false
    }
  ],
  "prefiles": [
    {
      "cid": 1234567,
      "name": "1234567",
      "callsign": "DAL1",
      "flight_plan": {
        "flight_rules": "I",
        "aircraft": "B764/H-SDE3FGHIM3RWXY/LB1",
        "aircraft_faa": "B764/L",
        "aircraft_short": "B764",
        "departure": "KJFK",
        "arrival": "EGLL",
        "alternate": "EGBB",
        "deptime": "0000",
        "enroute_time": "0615",
        "fuel_time": "0745",
        "remarks": "/V/",
        "route": "GREKI DCT JUDDS DCT MARTN DCT BAREE DCT NEEKO NATX LIMRI NATX XETBO DCT EVRIN DCT INFEC DCT JETZI DCT OGLUN DCT OCTIZ P2 SIRIC SIRI1H",
        "revision_id": 1,
        "assigned_transponder": "3456"
      },
      "last_updated": "1970-01-01T00:00:00.000000Z"
    }
  ],
  "facilities": [
    {
      "id": 0,
      "short": "FAC",
      "long_name": "Example Facility"
    }
  ],
  "ratings": [
    {
      "id": 0,
      "short_name": "EXMP",
      "long_name": "Example Rating"
    }
  ],
  "pilot_ratings": [
    {
      "id": 0,
      "short_name": "EXMP",
      "long_name": "Example Rating"
    }
  ],
  "military_ratings": [
    {
      "id": 0,
      "short_name": "EXMP",
      "long_name": "Example Rating"
    }
  ]
}

Loading...