openapi: 3.1.0
info:
  title: VATSIM AIP Airport info Users API
  version: 2.0.0
  termsOfService: https://vatsim.net/docs/policy/user-agreement
  contact:
    email: tech@vatsim.net
    name: VATSIM Technology Team
servers:
- url: https://my.vatsim.net/api/v2/aip
tags:
- name: Users
paths:
  /users/info:
    get:
      tags:
      - Users
      summary: Get user connections
      description: "Returns the current connections for the specified user.\n\nThe response is a CSV file with the following fields:\n  * VATSIM ID\n  * Callsign\n  * Facility type (`pilot` or `atc`)\n  * Frequency (empty for pilots)\n  * Visual range (empty for pilots)\n  * Latitude\n  * Longitude\n  * Secondary positions  \n    (four or more lat/lon pairs, if set by the controller)\n  * Trailing comma"
      operationId: getUserInfo
      parameters:
      - name: cid
        in: query
        description: VATSIM ID of the user
        required: true
        schema:
          type: integer
        example: 1234567
      responses:
        '200':
          description: Successful operation
          content:
            text/plain:
              schema:
                type: string
                description: CSV of the specified user's connections
                example: 1234567,DAL1,pilot,,,40.64222,-73.76981,0,0,0,0,0,0,0,0,