VATSIM User API
The User API from VATSIM — 1 operation(s) for user.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/vatsim:vatsim-user-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: VATSIM Connect User API
version: 1.0.0
termsOfService: https://vatsim.net/docs/policy/user-agreement
contact:
email: tech@vatsim.net
name: VATSIM Technology Team
servers:
- url: https://auth.vatsim.net
description: Production
- url: https://auth-dev.vatsim.net
description: Sandbox
tags:
- name: User
paths:
/api/user:
get:
tags:
- User
summary: Get user details
description: Returns details about the authenticated user
operationId: getUser
security:
- connect:
- full_name
- email
- vatsim_details
- country
responses:
'200':
description: Successful operation
content:
application/json:
schema:
type: object
properties:
data:
$ref: '#/components/schemas/User'
'500':
description: Invalid client
content:
application/json:
schema:
$ref: '#/components/schemas/APIError'
components:
schemas:
User:
type: object
properties:
cid:
type: string
description: VATSIM ID
example: '1234567'
personal:
type: object
description: Personal details
properties:
name_first:
type: string
description: First name
example: Kennedy
name_last:
type: string
description: Last name
example: Steve
name_full:
type: string
description: Full name
example: Kennedy Steve
email:
type: string
description: Email address
example: k.steve@vatsim.net
country:
type: object
description: Country of residence
properties:
id:
type: string
description: Country code
example: US
name:
type: string
description: Country name
example: United States
vatsim:
type: object
properties:
rating:
type: object
description: Controller rating
properties:
id:
type: integer
description: Controller Rating ID
example: 0
short:
type: string
pattern: /[A-Z0-9]{2,4}/
description: Short identifier
example: EXMP
long:
type: string
description: Human-readable name
example: Example Rating
pilotrating:
type: object
description: Pilot rating
properties:
id:
type: integer
description: Pilot Rating ID
example: 0
short:
type: string
pattern: /[A-Z0-9]{2,4}/
description: Short identifier
example: EXMP
long:
type: string
description: Human-readable name
example: Example Rating
region:
type: object
description: Region
properties:
id:
type: string
description: Region ID
example: AMAS
name:
type: string
description: Region name
example: Americas
division:
type: object
description: Division
properties:
id:
type: string
description: Division ID
example: USA
name:
type: string
description: Division name
example: United States
subdivision:
type: object
description: Subdivision
properties:
id:
type: string
description: Subdivision ID
example: null
name:
type: string
description: Subdivision name
example: null
oauth:
type: object
properties:
token_valid:
type: string
description: Whether the access token is valid
enum:
- 'true'
- 'false'
APIError:
type: object
properties:
error_code:
type: string
description: Error code
enum:
- VSO1
- VSO2
- VSO3
log_code:
type: string
description: Reference ID for VATSIM staff
example: SSO7cQDRG
error:
type: string
description: Human-readable error message
securitySchemes:
connect:
type: oauth2
flows:
authorizationCode:
authorizationUrl: /oauth/authorize
tokenUrl: /oauth/token
scopes:
full_name: Read the user's full name
email: Read the user's email address
vatsim_details: Read the user's VATSIM ratings and divisions
country: Read the user's country of residence