> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flyhub.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Read airline profile

> Returns the profile attached to the bearer key. The airline is derived from the key; no airline ID can be supplied by the caller. This resource is not paginated.



## OpenAPI

````yaml /virtual-airlines/openapi.json get /api/v1/va/airline
openapi: 3.1.0
info:
  title: FlyHub Virtual Airlines API
  version: '2026-07-21'
  description: >-
    Read-only airline information and Discord notification payloads for Virtual
    Airlines integrations. Resources are scoped to the airline that issued the
    fhva_live bearer key.
servers:
  - url: https://flyhub.app
    description: FlyHub production API
security: []
tags:
  - name: public-api
    description: >-
      Read-only resources for airline websites, dashboards, and private
      integrations.
    x-group: Public VA API
  - name: discord-webhooks
    description: Discord notification payloads for selected airline activity.
    x-group: Discord webhooks
paths:
  /api/v1/va/airline:
    get:
      tags:
        - public-api
      summary: Read the airline profile
      description: >-
        Returns the profile attached to the bearer key. The airline is derived
        from the key; no airline ID can be supplied by the caller. This resource
        is not paginated.
      operationId: getVaAirline
      responses:
        '200':
          $ref: '#/components/responses/AirlineResponse'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/RateLimited'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
      security:
        - vaApiKey: []
components:
  responses:
    AirlineResponse:
      description: Airline profile returned.
      headers:
        Cache-Control:
          $ref: '#/components/headers/CacheControl'
        X-RateLimit-Limit:
          $ref: '#/components/headers/RateLimitLimit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/RateLimitRemaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/RateLimitReset'
      content:
        application/json:
          schema:
            type: object
            required:
              - data
              - meta
            properties:
              data:
                $ref: '#/components/schemas/Airline'
              meta:
                $ref: '#/components/schemas/Meta'
    Unauthorized:
      description: A valid FlyHub VA API key is required.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: The key does not include the required read scope.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    RateLimited:
      description: The request rate is temporarily limited.
      headers:
        Retry-After:
          $ref: '#/components/headers/RetryAfter'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    ServiceUnavailable:
      description: FlyHub cannot safely serve the request at the moment.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  headers:
    CacheControl:
      description: >-
        The response is private and should not be stored as a shared cache
        entry.
      schema:
        type: string
        example: private, no-store
    RateLimitLimit:
      description: Requests allowed in the current public API window.
      schema:
        type: integer
    RateLimitRemaining:
      description: Requests remaining in the current public API window.
      schema:
        type: integer
    RateLimitReset:
      description: ISO timestamp when the public API request window resets.
      schema:
        type: string
        format: date-time
    RetryAfter:
      description: Seconds to wait before retrying after a rate limit.
      schema:
        type: integer
  schemas:
    Airline:
      type: object
      required:
        - name
        - shortName
        - slug
        - summary
        - icaoCode
        - callsign
        - homeIcao
        - homeCountryCode
        - status
        - businessModel
        - applicationMode
        - pilotCount
        - fleetCount
        - createdAt
        - updatedAt
      properties:
        name:
          type: string
        shortName:
          type:
            - string
            - 'null'
        slug:
          type: string
        summary:
          type:
            - string
            - 'null'
        icaoCode:
          type: string
        callsign:
          type:
            - string
            - 'null'
        homeIcao:
          type:
            - string
            - 'null'
        homeCountryCode:
          type:
            - string
            - 'null'
        status:
          type: string
          enum:
            - active
            - distress
            - restructuring
        businessModel:
          description: >-
            Deprecated compatibility field; always null. Airlines no longer have
            a business-model classification.
          deprecated: true
          type:
            - string
            - 'null'
        applicationMode:
          type:
            - string
            - 'null'
        pilotCount:
          type: integer
          minimum: 0
        fleetCount:
          type: integer
          minimum: 0
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
    Meta:
      type: object
      required:
        - apiVersion
      properties:
        apiVersion:
          type: string
          example: '2026-07-21'
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
            message:
              type: string
  securitySchemes:
    vaApiKey:
      type: http
      scheme: bearer
      bearerFormat: fhva_live_...
      description: >-
        A read-only FlyHub VA API key created from Ownership. Keep it on your
        integration server.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.