VATSIM Member

Updated Feb 07 2022

Return information about VATSIM member by his ID. Output is a JSON-string.

Output fields:

  • atctime: time spent by a member on ATC positions
  • rating: member's ATC rating. In case if integer requested, will return rating as a number.
    For the rating ID decoding, please refer to the ratings key of the feed.
  • cid: member's client ID
  • country: country specified by the member due his registration
  • countrystate: state of country specified by the member due his registration
  • division: member's current division
  • subdivision: member's current subdivision
  • lastratingchange: timestamp of the last change of member's rating
  • region: member's current region
  • pilotrating: if requested as a decoded variant, will contain a pilot ratings obtained separated by comma. In case if integer is requested, will return a bit mask representing ratings.
    For the pilot rating ID decoding, please refer to the pilot_ratings key of the feed.
  • pilottime: time spent by a member as pilot
  • regdate: member's registration date in VATSIM
  • susp_date: timestamp when member account was suspended or null if active

Usage

Endpoint: /member/{VATSIM_ID}

Request method: GET

Headers:

Header parameterDescription
X-API-Key Your unique API key
type Empty or str - return decoded values
int - return values as numbers

Example request:

Python

    import requests

    url = "https://api.vacc-ua.org/api/member/1300518"

    headers = {
        'X-API-Key': "123456",
        'type': "int",
        'Cache-Control': "no-cache"
    }

    response = requests.request("GET", url, headers=headers)
    print(response.text)

PHP

    <?php

    $curl = curl_init();

    curl_setopt_array($curl, array(
        CURLOPT_PORT => "443",
        CURLOPT_URL => "https://api.vacc-ua.org/api/member/1300518",
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_ENCODING => "",
        CURLOPT_MAXREDIRS => 10,
        CURLOPT_TIMEOUT => 30,
        CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
        CURLOPT_CUSTOMREQUEST => "GET",
        CURLOPT_HTTPHEADER => array(
            "Cache-Control: no-cache",
            "X-API-Key: 123456",
            "type: int"
        ),
    ));

    $response = curl_exec($curl);
    $err = curl_error($curl);

    curl_close($curl);

    if ($err) {
        echo "cURL Error #:" . $err;
    } else {
        echo $response;
    }

Example response:


{
    "result": {
        "atctime": "1221.54",
        "cid": "1300518",
        "country": "UA",
        "countystate": "",
        "division": "RUS",
        "lastratingchange": "2021-01-08 15:51:38",
        "pilotrating": 3,
        "pilottime": "2059.43",
        "rating": 7,
        "regdate": "2014-08-26 14:47:17",
        "region": "EMEA",
        "subdivision": "UKRA",
        "susp_date": null
    }
}