FlightAware Account API

The account surface of AeroAPI — GET /account/usage, added in AeroAPI 4.30.0. It reports the calling account's AeroAPI consumption over a requested period, and it is the only in-band signal a consumer has for its own spend: AeroAPI returns no rate-limit response headers and declares no 429, so headroom and cost must be polled from here rather than read off a response.

Operations 1

GET /account/usage Get AeroAPI usage statistics for account #

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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/flightaware-account-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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

flightaware-account-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Flightaware Account API
  version: 4.30.0
  description: 'Operations tagged account across 2 of this provider''s published API definitions: flightaware-openapi.yml, flightaware-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://{env}.flightaware.com/aeroapi
  variables:
    env:
      default: aeroapi
      enum:
      - aeroapi
security:
- ApiKeyAuth: []
tags:
- name: account
paths:
  /account/usage:
    get:
      operationId: get_account_usage
      summary: Get AeroAPI usage statistics for account
      description: 'Returns usage statistics for your AeroAPI account. Can be filtered

        by key and date range. Data per account is updated every 10 minutes.

        '
      tags:
      - account
      parameters:
      - in: query
        name: start
        description: 'Datetime or date to start gathering usage data from. If left blank,

          will default to 1 year into the past. Has a maximum value of 1 year into

          the past. If using date instead of datetime, then the time will default to 00:00:00Z.

          Thus, the next day''s date should be specified if one day of data is desired when

          using date instead of datetime.

          '
        schema:
          type: string
          oneOf:
          - format: date-time
          - format: date
        examples:
          datetime:
            value: '2023-12-31T19:59:59Z'
          date:
            value: '2023-12-31'
        x-fill-example: 'no'
      - in: query
        name: end
        description: 'Datetime or date to end gathering usage data from. If left blank,

          will default to the current time. Has a maximum value of 1 year into the past

          If using date instead of datetime, then the time will default to 00:00:00Z.

          Thus, the next day''s date should be specified if one day of data is desired when

          using date instead of datetime.

          '
        schema:
          type: string
          oneOf:
          - format: date-time
          - format: date
        examples:
          datetime:
            value: '2023-12-31T19:59:59Z'
          date:
            value: '2023-12-31'
        x-fill-example: 'no'
      - in: query
        name: all_keys
        description: 'Flag to determine which key(s) to get usage data for. If False, data for the key

          that made the request will be retrieved. If True, data for all keys

          associated with the account will be retrieved.

          '
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: OK
          content:
            application/json; charset=UTF-8:
              schema:
                type: object
                properties:
                  total_calls:
                    type: integer
                    description: 'Total number of calls across all resources

                      '
                  total_pages:
                    type: integer
                    description: 'Total number of pages retrieved across all resources

                      '
                  total_cost:
                    type: number
                    description: 'Total cost for all calls made across all resources.

                      Does not include volume discounting

                      '
                  total_discount_cost:
                    type: number
                    description: 'Total cost across all resources including volume discounting.

                      (Total cost minus discount)

                      '
                  total_successful_calls:
                    type: integer
                    description: 'Total number of successful calls across all resources

                      '
                  total_failed_calls:
                    type: integer
                    description: 'Total number of failed calls across all resources

                      '
                  resource_details:
                    type: array
                    items:
                      type: object
                      properties:
                        operation:
                          type: string
                          description: 'Name of the operation

                            '
                        total_resource_calls:
                          type: integer
                          description: 'Total number of calls made for this resource

                            '
                        num_pages:
                          type: integer
                          description: 'Total number of pages retrieved for this resource

                            '
                        resource_cost:
                          type: number
                          description: 'Total cost for all calls made to this resource.

                            Does not include volume discounting

                            '
                        successful_resource_calls:
                          type: integer
                          description: 'Total number of successful calls for this resource

                            '
                        failed_resource_calls:
                          type: integer
                          description: 'Total number of failed calls for this resource

                            '
                      required:
                      - operation
                      - total_resource_calls
                      - num_pages
                      - resource_cost
                      - successful_resource_calls
                      - failed_resource_calls
                    description: 'Resource specific information

                      '
                required:
                - total_calls
                - total_pages
                - total_cost
                - total_discount_cost
                - total_successful_calls
                - total_failed_calls
                - resource_details
        '400':
          description: 'Incorrect parameter(s).

            '
          content:
            application/json; charset=UTF-8:
              schema:
                title: Error
                type: object
                properties:
                  title:
                    type: string
                    description: Short summary of the type of error encountered.
                  reason:
                    type: string
                    description: Error type name directly from the backend.
                  detail:
                    type: string
                    description: 'More detailed description of the error, possibly including information

                      about specific invalid fields or remediation steps.

                      '
                  status:
                    type: integer
                    description: The HTTP response code returned as part of the error.
                required:
                - title
                - reason
                - detail
                - status
    servers:
    - url: https://{env}.flightaware.com/aeroapi
      variables:
        env:
          default: aeroapi
          enum:
          - aeroapi
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-apikey
      description: 'Unlike previous versions of AeroAPI, authentication is now controlled by

        an API key that must be set in the header ```x-apikey```. Your

        FlightAware username is not used when authenticating to the API.

        '
x-refined-from:
- flightaware-openapi.yml
- flightaware-openapi.yml