VATSIM Member


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

Output fields:

  • atctime: time spent by member on ATC positions
  • rating: member ATC rating. In case if integer requested, will return rating as a number.
    • 0 - banned
    • 1 - Pilot/Observer
    • 2 - S1 Tower trainee
    • 3 - S2 Tower controller
    • 4 - S3 TMA controller
    • 5 - C1 Enroute controller
    • 7 - C3 Senior controller
    • 8 - I1 Instructor
    • 10 - I3 Senior instructor
    • 11 - Network supervisor
    • 12 - Network administrator
  • cid: member client ID
  • country: country specified by member due his registration
  • division: member current division
  • region: member current region
  • name_first: first name
  • name_last: last name
  • pilot_rating: if requested as a decoded variant, will contain pilot ratings obtained separated by comma. In case if integer requested, will return bit mask representing ratings.
    • P1 = 1
    • P2 = 2
    • P3 = 4
    • P4 = 8
    • P5 = 16
    • and so on...
    So pilot with P1 and P2 ratings will have bitmask of 3 (1+2). Pilot with P1, P2 and P4 - 11 (1+2+8).
  • pilottime: time spent by member as pilot
  • regdate: member registration date in VATSIM

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": "505.554",
        "cid": "1300518",
        "country": "UA",
        "division": "RUS",
        "name_first": "Andrey",
        "name_last": "Prokhorov",
        "pilotrating": "11",
        "pilottime": "1217.56",
        "rating": "8",
        "regdate": "2014-08-26 14:47:17",
        "region": "EUR"
    }
}