VATSIM

Read live data from VATSIM, the worldwide flight simulation network where volunteer pilots and air traffic controllers fly and staff a shared virtual sky. See who is flying and controlling right now with positions, flight plans and frequencies, read ATIS broadcasts and METAR weather, look up a member's ratings, hours, flights and controlling sessions, browse the events calendar, and read airport and airspace reference data. Free to use, with no account or API key required.

Actions

Action	What it does
Check if a member is online	Check whether a member is connected to VATSIM right now, and read that connection if they are.
Export the events calendar	Export every current and upcoming VATSIM event as an iCalendar (.ics) feed, ready to save as a file or subscribe to from a calendar app.
Find a member by Discord ID	Find the VATSIM ID behind a Discord account, for members who have linked the two in VATSIM's community portal.
Get a member	Get a VATSIM member's profile by their VATSIM ID: controller rating, pilot rating, military rating, the region, division and subdivision they belong to, when they joined, and when their rating last changed.
Get a member's hours	Get how many hours a member has flown and controlled on VATSIM, broken down by the rating they held at the time (S1, S2, S3, C1, C3, I1, I3, supervisor and administrator).
Get a member's live connections	Get a member's live connections as VATSIM's audio network sees them: the callsign, whether they are flying or controlling, the frequency and visual range for a controller, their position, and any secondary positions they have set.
Get airspace map data	Get the download links for VATSIM's current airspace data: the FIR boundary files (as .dat and as GeoJSON) and the VATSpy dataset, plus the version they belong to.
Get an airport	Get an airport's entry in VATSIM's AIP: its name, IATA code, city and country, elevation, transition altitude and level, the FIR it sits in, the division that maintains it, local notes for pilots, and the controller positions that serve it.
Get an event	Get one VATSIM event by its id: the full briefing, start and end times, the airports and suggested routes, the organising division, and the banner image.
Get an online controller	Get one controller who is online right now, by position callsign or VATSIM ID: their frequency, rating, visual range, how long they have been logged on and their controller info text.
Get an online pilot	Get one pilot who is flying on VATSIM right now, by callsign or VATSIM ID: their live position, altitude, groundspeed, heading, transponder and the flight plan they filed.
Get METAR weather	Get the current METAR weather report VATSIM is using for one airport or several.
Get network summary	Get how busy VATSIM is right now: connected clients, unique users, and how many pilots, controllers, ATIS stations and prefiled flight plans there are.
List a division's events	List the events one VATSIM division is running now or has coming up, optionally narrowed to a date range.
List a member's controlling sessions	List a member's past controlling sessions, newest first, each with the position worked, the times, and the session's traffic counters: aircraft tracked and seen, flight plans amended, and handoffs initiated, received and refused.
List a member's flight plans	List the last 50 flight plans a member filed, each with the route, aircraft, cruise altitude, departure and arrival airports and remarks.
List a member's flights	List a member's past pilot connections, newest first, with the callsign, server, and the start and end time of every flight they have flown on VATSIM.
List a region's events	List the events running now or coming up anywhere in one of VATSIM's three regions, optionally narrowed to a date range.
List an airport's stations	List the controller positions that serve an airport (centre, approach, departure, tower, ground and delivery) with each one's callsign, name, frequency, and whether it is the unicom/CTAF frequency to use when nobody is online.
List audio transceivers	List the radio transceivers every connected client is listening and transmitting on, with each one's frequency (in hertz and in megahertz), position and height.
List countries	List every country VATSIM recognises, with the region, division and vACC that covers it.
List divisions	List VATSIM's divisions with the region each belongs to and whether it is split into subdivisions.
List events	List the events running now or coming up across VATSIM, each with its start and end time, the airports and routes involved, who is organising it, the briefing and the banner image.
List FSD servers	List the FSD servers pilot and controller clients connect to, with each one's hostname, location and whether it is currently accepting connections.
List online ATIS stations	List the ATIS broadcasts running on VATSIM right now, each with its information letter, frequency, position and the full spoken text.
List online controller connections	List every live controller connection as VATSIM's ATC API records it: the connection id, position callsign, server, rating and logon time.
List online controllers	List the air traffic controllers staffing VATSIM right now, with their position callsign, frequency, rating, visual range and controller info text.
List online pilot connections	List every live pilot connection as VATSIM's member API records it: the connection id, callsign, server, logon time and the flight plan on file.
List online pilots	List the pilots flying on VATSIM right now, with their live position, altitude, groundspeed, transponder and filed flight plan.
List prefiled flight plans	List the flight plans pilots have filed but not yet connected to fly, the network's departure board for the next few hours.
List regions	List VATSIM's three regions (Americas, Asia Pacific, and Europe, Middle East and Africa) with the VATSIM ID of each region's director.
List subdivisions	List VATSIM's subdivisions, the vACCs and virtual area control centres inside a division, with the division each belongs to.

Check if a member is online

Check whether a member is connected to VATSIM right now, and read that connection if they are. Returns online as false rather than failing when they are offline, so a workflow can branch on it directly.

Inputs

VATSIM IDcidtextRequired: The member's VATSIM ID (CID), the number they sign in with. For example 1234567.

Outputs

connectionobject
onlinetrue/false

Example output

{
  "connection": {
    "callsign": "BAW178",
    "end": null,
    "id": 41220913,
    "rating": 1,
    "server": "USA-EAST",
    "start": "2026-08-15T01:12:04Z",
    "type": 1,
    "vatsim_id": "1234567"
  },
  "online": true
}

Export the events calendar

Export every current and upcoming VATSIM event as an iCalendar (.ics) feed, ready to save as a file or subscribe to from a calendar app.

Inputs

None.

Outputs

calendartext
event_countnumber

Example output

{
  "calendar": "BEGIN:VCALENDAR\r\nVERSION:2.0\r\nNAME:VATSIM Events\r\nBEGIN:VEVENT\r\nSUMMARY:Garden City to Capital City\r\nDTSTART:20260815T070000Z\r\nDTEND:20260815T093000Z\r\nEND:VEVENT\r\nEND:VCALENDAR",
  "content_type": "text/calendar",
  "event_count": 1,
  "filename": "vatsim-events.ics"
}

Find a member by Discord ID

Find the VATSIM ID behind a Discord account, for members who have linked the two in VATSIM's community portal. Returns linked as false rather than failing when there is no link, so a workflow can branch on it.

Inputs

Discord user IDdiscord_user_idtextRequired: The Discord account's numeric user id (for example 123456789012345678), not their username.

Outputs

linkedtrue/false
vatsim_idtext

Example output

{
  "discord_user_id": "123456789012345678",
  "linked": true,
  "record": {
    "id": "1234567",
    "user_id": "123456789012345678"
  },
  "vatsim_id": "1234567"
}

Get a member

Get a VATSIM member's profile by their VATSIM ID: controller rating, pilot rating, military rating, the region, division and subdivision they belong to, when they joined, and when their rating last changed.

Inputs

VATSIM IDcidtextRequired: The member's VATSIM ID (CID), the number they sign in with. For example 1234567.

Outputs

memberobject

Example output

{
  "member": {
    "division_id": "EUD",
    "id": 1234567,
    "lastratingchange": "2024-03-02T11:04:00Z",
    "militaryrating": 0,
    "pilotrating": 1,
    "rating": 5,
    "reg_date": "2012-08-09T20:39:48Z",
    "region_id": "EMEA",
    "subdivision_id": "CZCH",
    "susp_date": null
  }
}

Get a member's hours

Get how many hours a member has flown and controlled on VATSIM, broken down by the rating they held at the time (S1, S2, S3, C1, C3, I1, I3, supervisor and administrator).

Inputs

VATSIM IDcidtextRequired: The member's VATSIM ID (CID), the number they sign in with. For example 1234567.

Outputs

statsobject

Example output

{
  "stats": {
    "adm": 0.0,
    "atc": 512.42,
    "c1": 262.72,
    "c2": 0.0,
    "c3": 0.0,
    "i1": 0.0,
    "i2": 0.0,
    "i3": 0.0,
    "id": 1234567,
    "pilot": 1840.83,
    "s1": 41.5,
    "s2": 88.2,
    "s3": 120.0,
    "sup": 0.0
  }
}

Get a member's live connections

Get a member's live connections as VATSIM's audio network sees them: the callsign, whether they are flying or controlling, the frequency and visual range for a controller, their position, and any secondary positions they have set. Returns online as false when they are not connected.

Inputs

VATSIM IDcidtextRequired: The member's VATSIM ID (CID), the number they sign in with. For example 1234567.

Outputs

connectionslist
onlinetrue/false

Example output

{
  "connections": [
    {
      "callsign": "EGLL_TWR",
      "facility_type": "atc",
      "frequency": 118.5,
      "latitude": 51.4775,
      "longitude": -0.4614,
      "secondary_positions": [],
      "vatsim_id": "1234567",
      "visual_range": 50
    }
  ],
  "count": 1,
  "online": true,
  "vatsim_id": "1234567"
}

Get airspace map data

Get the download links for VATSIM's current airspace data: the FIR boundary files (as .dat and as GeoJSON) and the VATSpy dataset, plus the version they belong to. Use these to draw controller boundaries on a map.

Inputs

None.

Outputs

map_dataobject

Example output

{
  "map_data": {
    "current_commit_hash": "v2608.2",
    "fir_boundaries_dat_url": "https://github.com/vatsimnetwork/vatspy-data-project/releases/download/v2608.2/FIRBoundaries.dat",
    "fir_boundaries_geojson_url": "https://github.com/vatsimnetwork/vatspy-data-project/releases/download/v2608.2/Boundaries.geojson",
    "vatspy_dat_url": "https://github.com/vatsimnetwork/vatspy-data-project/releases/download/v2608.2/VATSpy.dat"
  }
}

Get an airport

Get an airport's entry in VATSIM's AIP: its name, IATA code, city and country, elevation, transition altitude and level, the FIR it sits in, the division that maintains it, local notes for pilots, and the controller positions that serve it.

Inputs

AirporticaotextRequired: The airport's four-letter ICAO code.

Outputs

airportobject

Example output

{
  "airport": {
    "altitude_ft": 13,
    "altitude_m": 3,
    "city": "New York, New York",
    "country": "United States",
    "division_id": "USA",
    "fir_code": "KZNY",
    "general_information": "John F Kennedy International Airport",
    "iata": "JFK",
    "icao": "KJFK",
    "name": "John F Kennedy International Airport",
    "stations": [
      {
        "callsign": "JFK_TWR",
        "ctaf": true,
        "frequency": "119.100",
        "name": "Kennedy Tower"
      }
    ],
    "subdivision_id": null,
    "transition_alt": 18000,
    "transition_level": "FL180",
    "transition_level_by_atc": false
  }
}

Get an event

Get one VATSIM event by its id: the full briefing, start and end times, the airports and suggested routes, the organising division, and the banner image.

Inputs

Event IDevent_idnumberRequired: The event's numeric id, as returned by any of the event listing actions.At least 1.

Outputs

eventobject

Example output

{
  "event": {
    "airports": [
      {
        "icao": "NZCH"
      },
      {
        "icao": "NZWN"
      }
    ],
    "banner": "https://vatsim-my.nyc3.digitaloceanspaces.com/events/banner.png",
    "description": "Join us for an evening of IFR flying...",
    "end_time": "2026-08-15T09:30:00.000000Z",
    "id": 20509,
    "link": "https://my.vatsim.net/events/garden-city-to-capital-city",
    "name": "Garden City to Capital City",
    "organisers": [
      {
        "division": "NZ",
        "organised_by_vatsim": false,
        "region": "APAC",
        "subdivision": null
      }
    ],
    "routes": [
      {
        "arrival": "NZWN",
        "departure": "NZCH",
        "route": "CHWN1: Y393"
      }
    ],
    "short_description": "An evening of IFR flying between Christchurch and Wellington.",
    "start_time": "2026-08-15T07:00:00.000000Z",
    "type": "Event"
  }
}

Get an online controller

Get one controller who is online right now, by position callsign or VATSIM ID: their frequency, rating, visual range, how long they have been logged on and their controller info text.

Inputs

Callsign or VATSIM IDcontrollertextRequired: The controller's position callsign (for example EGLL_TWR) or their VATSIM ID.

Outputs

controllerobject

Example output

{
  "controller": {
    "callsign": "EGLL_TWR",
    "cid": 1400001,
    "facility": 4,
    "frequency": "118.500",
    "last_updated": "2026-08-15T04:52:58.4771372Z",
    "logon_time": "2026-08-15T02:59:24.8367002Z",
    "name": "Sam Patel",
    "rating": 3,
    "server": "UK",
    "text_atis": [
      "Heathrow Tower",
      "Runway 27R in use"
    ],
    "visual_range": 50
  },
  "updated_at": "2026-08-15T04:53:10.7724157Z"
}

Get an online pilot

Get one pilot who is flying on VATSIM right now, by callsign or VATSIM ID: their live position, altitude, groundspeed, heading, transponder and the flight plan they filed.

Inputs

Callsign or VATSIM IDpilottextRequired: The pilot's callsign (for example BAW178) or their VATSIM ID.

Outputs

pilotobject

Example output

{
  "pilot": {
    "altitude": 36012,
    "callsign": "BAW178",
    "cid": 1234567,
    "flight_plan": {
      "aircraft": "B738/M-SDE2E3FGHIRWXY/LB1",
      "aircraft_faa": "B738/L",
      "aircraft_short": "B738",
      "alternate": "EGKK",
      "altitude": "36000",
      "arrival": "EGLL",
      "assigned_transponder": "6254",
      "cruise_tas": "460",
      "departure": "KJFK",
      "deptime": "0115",
      "enroute_time": "0640",
      "flight_rules": "I",
      "fuel_time": "0820",
      "remarks": "PBN/A1B1C1D1 DOF/260815 REG/N337PJ RMK/TCAS SIMBRIEF /V/",
      "revision_id": 1,
      "route": "GREKI JOOPY NICSO 51N050W 52N040W DINIM ETIKI BABAN"
    },
    "groundspeed": 471,
    "heading": 68,
    "last_updated": "2026-08-15T04:53:10.7413243Z",
    "latitude": 45.1024,
    "logon_time": "2026-08-15T01:12:04.1344699Z",
    "longitude": -55.4471,
    "military_rating": 0,
    "name": "Alex Carter KJFK",
    "pilot_rating": 1,
    "qnh_i_hg": 29.92,
    "qnh_mb": 1013,
    "server": "USA-EAST",
    "transponder": "6254"
  },
  "updated_at": "2026-08-15T04:53:10.7724157Z"
}

Get METAR weather

Get the current METAR weather report VATSIM is using for one airport or several. Enter full ICAO codes such as KJFK, a prefix of one to three characters such as EG for every UK airport, or ALL for the whole world.

Inputs

AirportsairportslistRequired: The airports to read, as ICAO codes (for example KJFK). A code of three characters or fewer is treated as a prefix, and ALL returns every airport.
Maximum reportslimitnumber: How many reports to return, from 1 to 10000. Defaults to 100, which matters only when you ask for a prefix or for ALL.From 1 to 10000. Default: 100.

Outputs

countnumber
metarslist

Example output

{
  "count": 1,
  "metars": [
    {
      "airport": "KJFK",
      "metar": "KJFK 150451Z 02007KT 10SM FEW100 SCT250 23/18 A3010 RMK AO2 SLP192 T02330183"
    }
  ],
  "requested": [
    "KJFK"
  ],
  "returned": 1
}

Get network summary

Get how busy VATSIM is right now: connected clients, unique users, and how many pilots, controllers, ATIS stations and prefiled flight plans there are. Also returns the network's reference tables for controller facilities, controller ratings, pilot ratings and military ratings.

Inputs

None.

Outputs

countsobject
generalobject

Example output

{
  "counts": {
    "atis": 27,
    "controllers": 54,
    "pilots": 758,
    "prefiles": 141,
    "servers": 10
  },
  "facilities": [
    {
      "id": 4,
      "long": "Tower",
      "short": "TWR"
    }
  ],
  "general": {
    "connected_clients": 839,
    "reload": 1,
    "unique_users": 811,
    "update": "20260815045310",
    "update_timestamp": "2026-08-15T04:53:10.7724157Z",
    "version": 3
  },
  "military_ratings": [
    {
      "id": 0,
      "long_name": "No Military Rating",
      "short_name": "M0"
    }
  ],
  "pilot_ratings": [
    {
      "id": 1,
      "long_name": "Private Pilot License",
      "short_name": "PPL"
    }
  ],
  "ratings": [
    {
      "id": 5,
      "long": "Enroute Controller",
      "short": "C1"
    }
  ]
}

List a division's events

List the events one VATSIM division is running now or has coming up, optionally narrowed to a date range.

Inputs

Divisiondivision_idtextRequired: Whose events to list.
Starting on or afterstarts_afterdate and time: Only return events that start at or after this date and time. Leave blank for all upcoming events.
Starting on or beforestarts_beforedate and time: Only return events that start at or before this date and time. Leave blank for all upcoming events.

Outputs

countnumber
eventslist

Example output

{
  "count": 1,
  "division_id": "USA",
  "events": [
    {
      "airports": [
        {
          "icao": "NZCH"
        },
        {
          "icao": "NZWN"
        }
      ],
      "banner": "https://vatsim-my.nyc3.digitaloceanspaces.com/events/banner.png",
      "description": "Join us for an evening of IFR flying...",
      "end_time": "2026-08-15T09:30:00.000000Z",
      "id": 20509,
      "link": "https://my.vatsim.net/events/garden-city-to-capital-city",
      "name": "Garden City to Capital City",
      "organisers": [
        {
          "division": "USA",
          "organised_by_vatsim": false,
          "region": "AMAS",
          "subdivision": null
        }
      ],
      "routes": [
        {
          "arrival": "NZWN",
          "departure": "NZCH",
          "route": "CHWN1: Y393"
        }
      ],
      "short_description": "An evening of IFR flying between Christchurch and Wellington.",
      "start_time": "2026-08-15T07:00:00.000000Z",
      "type": "Event"
    }
  ]
}

List a member's controlling sessions

List a member's past controlling sessions, newest first, each with the position worked, the times, and the session's traffic counters: aircraft tracked and seen, flight plans amended, and handoffs initiated, received and refused.

Inputs

VATSIM IDcidtextRequired: The member's VATSIM ID (CID), the number they sign in with. For example 1234567.
Maximum resultslimitnumber: How many records to return, from 1 to 1000. Defaults to 50.From 1 to 1000. Default: 50.
Records to skipoffsetnumber: How many records to skip before returning results. Use it with the maximum to page through a long list (0, then 50, then 100, ...).From 0 to 1000000. Default: 0.

Outputs

countnumber
sessionslist

Example output

{
  "count": 87,
  "sessions": [
    {
      "aircraftseen": 96,
      "aircrafttracked": 41,
      "connection_id": {
        "callsign": "BAW178",
        "end": "2026-08-14T15:50:08Z",
        "id": 32253111,
        "rating": 5,
        "server": "USA-EAST",
        "start": "2026-08-14T09:48:05Z",
        "type": 2,
        "vatsim_id": "1234567"
      },
      "flightsamended": 12,
      "handoffsinitiated": 22,
      "handoffsreceived": 19,
      "handoffsrefused": 0,
      "squawksassigned": 34
    }
  ]
}

List a member's flight plans

List the last 50 flight plans a member filed, each with the route, aircraft, cruise altitude, departure and arrival airports and remarks. Narrow it to one city pair.

Inputs

VATSIM IDcidtextRequired: The member's VATSIM ID (CID), the number they sign in with. For example 1234567.
Departure airportdeparturetext: Only return flights departing this airport, as an ICAO code (for example KJFK). Leave blank for all.
Arrival airportarrivaltext: Only return flights arriving at this airport, as an ICAO code (for example EGLL). Leave blank for all.
Maximum resultslimitnumber: How many records to return, from 1 to 1000. Defaults to 50.From 1 to 1000. Default: 50.

Outputs

countnumber
flight_planslist

Example output

{
  "count": 2,
  "flight_plans": [
    {
      "aircraft": "B738/M-SDE2E3FGHIRWXY/LB1",
      "alt": "EGKK",
      "altitude": "36000",
      "arr": "EGLL",
      "assignedsquawk": "6254",
      "callsign": "BAW178",
      "connection_id": 41220913,
      "cruisespeed": "460",
      "dep": "KJFK",
      "deptime": "0115",
      "filed": "2026-08-15T00:41:00Z",
      "flight_type": "I",
      "hrsenroute": 6,
      "hrsfuel": 8,
      "id": 88213344,
      "minenroute": 40,
      "minsfuel": 20,
      "modifiedbycallsign": null,
      "modifiedbycid": null,
      "rmks": "SIMBRIEF /V/",
      "route": "GREKI JOOPY NICSO DINIM ETIKI BABAN",
      "vatsim_id": "1234567"
    }
  ],
  "returned": 1
}

List a member's flights

List a member's past pilot connections, newest first, with the callsign, server, and the start and end time of every flight they have flown on VATSIM. Page through a long logbook with the maximum and skip fields.

Inputs

VATSIM IDcidtextRequired: The member's VATSIM ID (CID), the number they sign in with. For example 1234567.
Maximum resultslimitnumber: How many records to return, from 1 to 1000. Defaults to 50.From 1 to 1000. Default: 50.
Records to skipoffsetnumber: How many records to skip before returning results. Use it with the maximum to page through a long list (0, then 50, then 100, ...).From 0 to 1000000. Default: 0.

Outputs

countnumber
sessionslist

Example output

{
  "count": 412,
  "sessions": [
    {
      "callsign": "BAW178",
      "end": "2026-08-14T15:50:08Z",
      "id": 32253111,
      "rating": 1,
      "server": "USA-EAST",
      "start": "2026-08-14T09:48:05Z",
      "type": 1,
      "vatsim_id": "1234567"
    }
  ]
}

List a region's events

List the events running now or coming up anywhere in one of VATSIM's three regions, optionally narrowed to a date range.

Inputs

Regionregion_idtextRequired: Whose events to list.
Starting on or afterstarts_afterdate and time: Only return events that start at or after this date and time. Leave blank for all upcoming events.
Starting on or beforestarts_beforedate and time: Only return events that start at or before this date and time. Leave blank for all upcoming events.

Outputs

countnumber
eventslist

Example output

{
  "count": 1,
  "events": [
    {
      "airports": [
        {
          "icao": "NZCH"
        },
        {
          "icao": "NZWN"
        }
      ],
      "banner": "https://vatsim-my.nyc3.digitaloceanspaces.com/events/banner.png",
      "description": "Join us for an evening of IFR flying...",
      "end_time": "2026-08-15T09:30:00.000000Z",
      "id": 20509,
      "link": "https://my.vatsim.net/events/garden-city-to-capital-city",
      "name": "Garden City to Capital City",
      "organisers": [
        {
          "division": "NZ",
          "organised_by_vatsim": false,
          "region": "APAC",
          "subdivision": null
        }
      ],
      "routes": [
        {
          "arrival": "NZWN",
          "departure": "NZCH",
          "route": "CHWN1: Y393"
        }
      ],
      "short_description": "An evening of IFR flying between Christchurch and Wellington.",
      "start_time": "2026-08-15T07:00:00.000000Z",
      "type": "Event"
    }
  ],
  "region_id": "AMAS"
}

List an airport's stations

List the controller positions that serve an airport (centre, approach, departure, tower, ground and delivery) with each one's callsign, name, frequency, and whether it is the unicom/CTAF frequency to use when nobody is online.

Inputs

AirporticaotextRequired: The airport's four-letter ICAO code.

Outputs

countnumber
stationslist

Example output

{
  "count": 2,
  "icao": "KJFK",
  "stations": [
    {
      "callsign": "JFK_TWR",
      "ctaf": true,
      "frequency": "119.100",
      "name": "Kennedy Tower"
    },
    {
      "callsign": "JFK_GND",
      "ctaf": false,
      "frequency": "121.900",
      "name": "Kennedy Ground"
    }
  ]
}

List audio transceivers

List the radio transceivers every connected client is listening and transmitting on, with each one's frequency (in hertz and in megahertz), position and height. This is what decides who can hear whom on VATSIM's voice network.

Inputs

Callsign containscallsigntext: Only return records whose callsign contains this text (for example BAW for British Airways flights). Leave blank for all.
Maximum resultslimitnumber: How many records to return, from 1 to 1000. Defaults to 50.From 1 to 1000. Default: 50.

Outputs

clientslist
countnumber

Example output

{
  "clients": [
    {
      "callsign": "BAW178",
      "shoutLineIds": [],
      "transceivers": [
        {
          "frequency": 122800002,
          "frequency_mhz": 122.8,
          "heightAglM": 10972.8,
          "heightMslM": 10972.8,
          "id": 1,
          "latDeg": 45.1024,
          "lonDeg": -55.4471,
          "rco": false
        }
      ]
    }
  ],
  "count": 839,
  "returned": 1
}

List countries

List every country VATSIM recognises, with the region, division and vACC that covers it. Pick one country to read just that record.

Inputs

Countrycountry_codetext: Read just this country. Leave blank to list them all.

Outputs

countnumber
countrieslist

Example output

{
  "count": 251,
  "countries": [
    {
      "code": "US",
      "division": "USA",
      "name": "United States of America",
      "region": "AMAS",
      "vacc": null
    }
  ]
}

List divisions

List VATSIM's divisions with the region each belongs to and whether it is split into subdivisions. Pick one division to read just that record.

Inputs

Divisiondivision_idtext: Read just this division. Leave blank to list them all.

Outputs

countnumber
divisionslist

Example output

{
  "count": 21,
  "divisions": [
    {
      "id": "USA",
      "name": "United States",
      "parentregion": "AMAS",
      "subdivisionallowed": 0
    },
    {
      "id": "MENA",
      "name": "Middle East and North Africa",
      "parentregion": "EMEA",
      "subdivisionallowed": 1
    }
  ]
}

List events

List the events running now or coming up across VATSIM, each with its start and end time, the airports and routes involved, who is organising it, the briefing and the banner image. Limit how many you get back, or narrow them to a date range.

Inputs

Number of eventscountnumber: How many of the next events to ask VATSIM for. Leave blank for every current and upcoming event.From 1 to 1000.
Starting on or afterstarts_afterdate and time: Only return events that start at or after this date and time. Leave blank for all upcoming events.
Starting on or beforestarts_beforedate and time: Only return events that start at or before this date and time. Leave blank for all upcoming events.

Outputs

countnumber
eventslist

Example output

{
  "count": 1,
  "events": [
    {
      "airports": [
        {
          "icao": "NZCH"
        },
        {
          "icao": "NZWN"
        }
      ],
      "banner": "https://vatsim-my.nyc3.digitaloceanspaces.com/events/banner.png",
      "description": "Join us for an evening of IFR flying...",
      "end_time": "2026-08-15T09:30:00.000000Z",
      "id": 20509,
      "link": "https://my.vatsim.net/events/garden-city-to-capital-city",
      "name": "Garden City to Capital City",
      "organisers": [
        {
          "division": "NZ",
          "organised_by_vatsim": false,
          "region": "APAC",
          "subdivision": null
        }
      ],
      "routes": [
        {
          "arrival": "NZWN",
          "departure": "NZCH",
          "route": "CHWN1: Y393"
        }
      ],
      "short_description": "An evening of IFR flying between Christchurch and Wellington.",
      "start_time": "2026-08-15T07:00:00.000000Z",
      "type": "Event"
    }
  ]
}

List FSD servers

List the FSD servers pilot and controller clients connect to, with each one's hostname, location and whether it is currently accepting connections. Choose the live network, the sweatbox training servers, or both.

Inputs

Which serversserver_settext: Which server list to read: the live network, the sweatbox servers used for training and exams, or all of them.One of: live (Live network servers), sweatbox (Sweatbox (training) servers), all (Every server). Default: live.

Outputs

countnumber
serverslist

Example output

{
  "count": 1,
  "server_set": "live",
  "servers": [
    {
      "client_connections_allowed": true,
      "clients_connection_allowed": 1,
      "hostname_or_ip": "fsd.connect.vatsim.net",
      "ident": "AUTOMATIC",
      "is_sweatbox": false,
      "location": "Everywhere",
      "name": "AUTOMATIC"
    }
  ]
}

List online ATIS stations

List the ATIS broadcasts running on VATSIM right now, each with its information letter, frequency, position and the full spoken text. This is the quickest way to read the active runways and conditions an airport is advertising. Narrow it to one airport.

Inputs

Airportairporttext: Only return ATIS for this airport, as an ICAO code (for example KBDL). Leave blank for every airport.
Callsign containscallsigntext: Only return ATIS whose callsign contains this text (for example _D_ATIS for departure ATIS). Leave blank for all.
Maximum resultslimitnumber: How many records to return, from 1 to 1000. Defaults to 50.From 1 to 1000. Default: 50.

Outputs

atislist
countnumber

Example output

{
  "atis": [
    {
      "atis_code": "K",
      "callsign": "KBDL_ATIS",
      "cid": 1400002,
      "facility": 4,
      "frequency": "118.150",
      "last_updated": "2026-08-15T04:53:05.4746654Z",
      "latitude": 41.93915,
      "logon_time": "2026-08-15T02:55:19.6676839Z",
      "longitude": -72.68337,
      "name": "Jo Rivera",
      "rating": 2,
      "real_name": "vATIS Connection KBDL",
      "server": "USA-EAST",
      "text_atis": [
        "BRADLEY INTERNATIONAL AIRPORT ATIS INFORMATION K. 0351Z. 01004KT",
        "10SM FEW250 17/16 A3012. RUNWAYS 6 AND 33 IN USE, EXPECT ILS APCH."
      ],
      "visual_range": 50
    }
  ],
  "count": 27,
  "returned": 1
}

List online controller connections

List every live controller connection as VATSIM's ATC API records it: the connection id, position callsign, server, rating and logon time. Use 'List online controllers' instead when you want frequencies and controller info text.

Inputs

Callsign containscallsigntext: Only return records whose callsign contains this text (for example BAW for British Airways flights). Leave blank for all.
Maximum resultslimitnumber: How many records to return, from 1 to 1000. Defaults to 50.From 1 to 1000. Default: 50.

Outputs

connectionslist
countnumber

Example output

{
  "connections": [
    {
      "callsign": "EGLL_TWR",
      "fp": null,
      "id": 1400001,
      "rating": 3,
      "server": "UK",
      "start": "2026-08-15T02:59:24Z"
    }
  ],
  "count": 53,
  "returned": 1
}

List online controllers

List the air traffic controllers staffing VATSIM right now, with their position callsign, frequency, rating, visual range and controller info text. Narrow the list by callsign, VATSIM ID, position type (tower, approach, centre and so on), controller rating, or server.

Inputs

Callsign containscallsigntext: Only return records whose callsign contains this text (for example BAW for British Airways flights). Leave blank for all.
VATSIM IDcidtext: Only return the controller with this VATSIM ID. Leave blank for all controllers.
Position typesfacilitieslist: Only return controllers working one of these position types. Leave empty for every position.One or more of: 0 (Observer (OBS)), 1 (Flight Service Station (FSS)), 2 (Clearance Delivery (DEL)), 3 (Ground (GND)), 4 (Tower (TWR)), 5 (Approach/Departure (APP)), 6 (Enroute Centre (CTR)).
Controller ratingsratingslist: Only return controllers holding one of these ratings. Leave empty for every rating.One or more of: -1 (Inactive (INAC)), 0 (Suspended (SUS)), 1 (Observer (OBS)), 2 (Tower Trainee (S1)), 3 (Tower Controller (S2)), 4 (Senior Student (S3)), 5 (Enroute Controller (C1)), 6 (Controller 2 (C2, not in use)), 7 (Senior Controller (C3)), 8 (Instructor (I1)), and 4 more.
Serversserverslist: Only return clients connected to these FSD servers. Leave empty for every server.
Maximum resultslimitnumber: How many records to return, from 1 to 1000. Defaults to 50.From 1 to 1000. Default: 50.

Outputs

controllerslist
countnumber

Example output

{
  "controllers": [
    {
      "callsign": "EGLL_TWR",
      "cid": 1400001,
      "facility": 4,
      "frequency": "118.500",
      "last_updated": "2026-08-15T04:52:58.4771372Z",
      "logon_time": "2026-08-15T02:59:24.8367002Z",
      "name": "Sam Patel",
      "rating": 3,
      "server": "UK",
      "text_atis": [
        "Heathrow Tower",
        "Runway 27R in use"
      ],
      "visual_range": 50
    }
  ],
  "count": 54,
  "returned": 1,
  "updated_at": "2026-08-15T04:53:10.7724157Z"
}

List online pilot connections

List every live pilot connection as VATSIM's member API records it: the connection id, callsign, server, logon time and the flight plan on file. Use 'List online pilots' instead when you want live positions and altitudes.

Inputs

Callsign containscallsigntext: Only return records whose callsign contains this text (for example BAW for British Airways flights). Leave blank for all.
Maximum resultslimitnumber: How many records to return, from 1 to 1000. Defaults to 50.From 1 to 1000. Default: 50.

Outputs

connectionslist
countnumber

Example output

{
  "connections": [
    {
      "callsign": "BAW178",
      "fp": null,
      "id": 1234567,
      "rating": 1,
      "server": "USA-EAST",
      "start": "2026-08-15T01:12:04Z"
    }
  ],
  "count": 808,
  "returned": 1
}

List online pilots

List the pilots flying on VATSIM right now, with their live position, altitude, groundspeed, transponder and filed flight plan. Narrow the list by callsign, VATSIM ID, departure or arrival airport, aircraft type, pilot or military rating, server, and an altitude band.

Inputs

Callsign containscallsigntext: Only return records whose callsign contains this text (for example BAW for British Airways flights). Leave blank for all.
VATSIM IDcidtext: Only return the pilot with this VATSIM ID. Leave blank for all pilots.
Departure airportdeparturetext: Only return flights departing this airport, as an ICAO code (for example KJFK). Leave blank for all.
Arrival airportarrivaltext: Only return flights arriving at this airport, as an ICAO code (for example EGLL). Leave blank for all.
Aircraft type containsaircrafttext: Only return flights whose filed aircraft type contains this text (for example A320). Leave blank for all.
Pilot ratingspilot_ratingslist: Only return pilots holding one of these VATSIM pilot ratings. Leave empty for every rating.One or more of: 0 (Basic Member (NEW)), 1 (Private Pilot License (PPL)), 3 (Instrument Rating (IR)), 7 (Commercial Multi-Engine License (CMEL)), 15 (Airline Transport Pilot License (ATPL)), 31 (Flight Instructor (FI)), 63 (Flight Examiner (FE)).
Military ratingsmilitary_ratingslist: Only return pilots holding one of these military ratings. Leave empty for every rating.One or more of: 0 (No Military Rating (M0)), 1 (Military Pilot License (M1)), 3 (Military Instrument Rating (M2)), 7 (Military Multi-Engine Rating (M3)), 15 (Military Mission Ready Pilot (M4)).
Serversserverslist: Only return clients connected to these FSD servers. Leave empty for every server.
Minimum altitude (feet)min_altitudenumber: Only return pilots at or above this altitude in feet (for example 30000 for aircraft at cruise). Leave blank for any altitude.From -2000 to 100000.
Maximum altitude (feet)max_altitudenumber: Only return pilots at or below this altitude in feet (for example 10000 for aircraft near an airport). Leave blank for any altitude.From -2000 to 100000.
Maximum resultslimitnumber: How many records to return, from 1 to 1000. Defaults to 50.From 1 to 1000. Default: 50.

Outputs

countnumber
pilotslist

Example output

{
  "count": 758,
  "pilots": [
    {
      "altitude": 36012,
      "callsign": "BAW178",
      "cid": 1234567,
      "flight_plan": {
        "aircraft": "B738/M-SDE2E3FGHIRWXY/LB1",
        "aircraft_faa": "B738/L",
        "aircraft_short": "B738",
        "alternate": "EGKK",
        "altitude": "36000",
        "arrival": "EGLL",
        "assigned_transponder": "6254",
        "cruise_tas": "460",
        "departure": "KJFK",
        "deptime": "0115",
        "enroute_time": "0640",
        "flight_rules": "I",
        "fuel_time": "0820",
        "remarks": "PBN/A1B1C1D1 DOF/260815 REG/N337PJ RMK/TCAS SIMBRIEF /V/",
        "revision_id": 1,
        "route": "GREKI JOOPY NICSO 51N050W 52N040W DINIM ETIKI BABAN"
      },
      "groundspeed": 471,
      "heading": 68,
      "last_updated": "2026-08-15T04:53:10.7413243Z",
      "latitude": 45.1024,
      "logon_time": "2026-08-15T01:12:04.1344699Z",
      "longitude": -55.4471,
      "military_rating": 0,
      "name": "Alex Carter KJFK",
      "pilot_rating": 1,
      "qnh_i_hg": 29.92,
      "qnh_mb": 1013,
      "server": "USA-EAST",
      "transponder": "6254"
    }
  ],
  "returned": 1,
  "updated_at": "2026-08-15T04:53:10.7724157Z"
}

List prefiled flight plans

List the flight plans pilots have filed but not yet connected to fly, the network's departure board for the next few hours. Narrow it by callsign, VATSIM ID, departure or arrival airport, or aircraft type.

Inputs

Callsign containscallsigntext: Only return records whose callsign contains this text (for example BAW for British Airways flights). Leave blank for all.
VATSIM IDcidtext: Only return the plan filed by this VATSIM ID. Leave blank for all.
Departure airportdeparturetext: Only return flights departing this airport, as an ICAO code (for example KJFK). Leave blank for all.
Arrival airportarrivaltext: Only return flights arriving at this airport, as an ICAO code (for example EGLL). Leave blank for all.
Aircraft type containsaircrafttext: Only return flights whose filed aircraft type contains this text (for example A320). Leave blank for all.
Maximum resultslimitnumber: How many records to return, from 1 to 1000. Defaults to 50.From 1 to 1000. Default: 50.

Outputs

countnumber
prefileslist

Example output

{
  "count": 141,
  "prefiles": [
    {
      "callsign": "AAL1935",
      "cid": 1531671,
      "flight_plan": {
        "aircraft": "B738/M-SDE2E3FGHIRWXY/LB1",
        "aircraft_faa": "B738/L",
        "aircraft_short": "B738",
        "alternate": "EGKK",
        "altitude": "36000",
        "arrival": "EGLL",
        "assigned_transponder": "6254",
        "cruise_tas": "460",
        "departure": "KJFK",
        "deptime": "0115",
        "enroute_time": "0640",
        "flight_rules": "I",
        "fuel_time": "0820",
        "remarks": "PBN/A1B1C1D1 DOF/260815 REG/N337PJ RMK/TCAS SIMBRIEF /V/",
        "revision_id": 1,
        "route": "GREKI JOOPY NICSO 51N050W 52N040W DINIM ETIKI BABAN"
      },
      "last_updated": "2026-08-15T01:53:04.3822505Z",
      "name": "1531671"
    }
  ],
  "returned": 1,
  "updated_at": "2026-08-15T04:53:10.7724157Z"
}

List regions

List VATSIM's three regions (Americas, Asia Pacific, and Europe, Middle East and Africa) with the VATSIM ID of each region's director. Pick one region to read just that record.

Inputs

Regionregion_idtext: Read just this region. Leave blank to list all three.

Outputs

countnumber
regionslist

Example output

{
  "count": 3,
  "regions": [
    {
      "director": "1013441",
      "id": "AMAS",
      "name": "Americas"
    },
    {
      "director": "901134",
      "id": "APAC",
      "name": "Asia Pacific"
    },
    {
      "director": "858680",
      "id": "EMEA",
      "name": "Europe, Middle East and Africa"
    }
  ]
}

List subdivisions

List VATSIM's subdivisions, the vACCs and virtual area control centres inside a division, with the division each belongs to. Narrow the list to one division, or pick a single subdivision to read just that record.

Inputs

Subdivisionsubdivision_idtext: Read just this subdivision. Leave blank to list them all.
Divisiondivision_idtext: Only list subdivisions inside this division. Leave blank for every division.

Outputs

countnumber
subdivisionslist

Example output

{
  "count": 110,
  "subdivisions": [
    {
      "code": "ARB",
      "fullname": "Arabian",
      "parentdivision": "MENA"
    },
    {
      "code": "ADRIA",
      "fullname": "Adria",
      "parentdivision": "EUD"
    }
  ]
}

ActionsCopy Anchor Link

Check if a member is onlineCopy Anchor Link

Inputs

Outputs

Export the events calendarCopy Anchor Link

Inputs

Outputs

Find a member by Discord IDCopy Anchor Link

Inputs

Outputs

Get a memberCopy Anchor Link

Inputs

Outputs

Get a member's hoursCopy Anchor Link

Inputs

Outputs

Get a member's live connectionsCopy Anchor Link

Inputs

Outputs

Get airspace map dataCopy Anchor Link

Inputs

Outputs

Get an airportCopy Anchor Link

Inputs

Outputs

Get an eventCopy Anchor Link

Inputs

Outputs

Get an online controllerCopy Anchor Link

Inputs

Outputs

Get an online pilotCopy Anchor Link

Inputs

Outputs

Get METAR weatherCopy Anchor Link

Inputs

Outputs

Get network summaryCopy Anchor Link

Inputs

Outputs

List a division's eventsCopy Anchor Link

Inputs

Outputs

List a member's controlling sessionsCopy Anchor Link

Inputs

Outputs

List a member's flight plansCopy Anchor Link

Inputs

Outputs

List a member's flightsCopy Anchor Link

Inputs

Outputs

List a region's eventsCopy Anchor Link

Inputs

Outputs

List an airport's stationsCopy Anchor Link

Inputs

Outputs

List audio transceiversCopy Anchor Link

Inputs

Outputs

List countriesCopy Anchor Link

Inputs

Outputs

List divisionsCopy Anchor Link

Inputs

Outputs

List eventsCopy Anchor Link

Inputs

Outputs

List FSD serversCopy Anchor Link

Inputs

Outputs

List online ATIS stationsCopy Anchor Link

Inputs

Outputs

List online controller connectionsCopy Anchor Link

Inputs

Outputs

Actions

Check if a member is online

Export the events calendar

Find a member by Discord ID

Get a member

Get a member's hours

Get a member's live connections

Get airspace map data

Get an airport

Get an event

Get an online controller

Get an online pilot

Get METAR weather

Get network summary

List a division's events

List a member's controlling sessions

List a member's flight plans

List a member's flights

List a region's events

List an airport's stations

List audio transceivers

List countries

List divisions

List events

List FSD servers

List online ATIS stations

List online controller connections

List online controllers

List online pilot connections

List online pilots

List prefiled flight plans

List regions

List subdivisions