AeroVia Logo
AeroVia
Home
Courses
Resources
Community
Shop
About
Back to Resources

Developers

API docs, endpoint directory, and embed tooling for developers

Build aerospace apps with AeroVia data and AI.

AeroVia brings together aerospace data, AI-powered answers, and aerospace tools in one place so you can build on top of the platform directly.

Structured aerospace data

Q&A for agent workflows

Personal API key access

Embeds and APIs in one place

AeroVia API

How it works

  • Use one API for courses, structured data, forum reads, and AeroVia Q&A.
  • Create a personal key with the Manage API keys button.
  • Include that key in your requests to authenticate.
  • Use course endpoints for learning content and Q&A for answer-based workflows.
  • Choose the API version that fits your integration.
  • Build against the documented API contract, not the website UI.

Access and billing

  • Create and revoke your own personal API keys.
  • Each key is tied to your AeroVia account.
  • An active supporter subscription is required to use the API.
  • Supporters get included usage by default.
  • If you need more, you can buy extra credits manually.
  • Automatic overages are not part of v1.

Request behavior

  • Success responses use `data` and `meta`.
  • Resource list endpoints return records without relationship expansion.
  • Detail endpoints expand direct relationships one layer deep.
  • Polymorphic relationships use `id` and `type`.
  • Usage appears in each response and in a dedicated usage endpoint.

What ships in v1

  • AeroVia courses and lesson content.
  • Core aerospace data resources.
  • Launch feeds.
  • Read-only forum posts, comments, and user profiles.
  • The AeroVia Q&A endpoint.
  • Account usage and credit tracking.

Authentication

Send your API key as a Bearer token on every authenticated request.

curl -H "Authorization: Bearer YOUR_AEROVIA_API_KEY" "https://api.aerovia.org/v1/account/usage"

Endpoints

Browse each API version by section, with request parameters, response fields, and examples.

Courses

6 endpoints

Aerospace courses with modules, lessons, and activities.

Courses

AeroVia courses with modules, lessons, and activities.

GET/v1/courses

List courses.

GET/v1/courses/{courseId}

Get one course outline with modules and lessons.

GET/v1/courses/{courseId}/modules

List modules for a course.

GET/v1/courses/{courseId}/modules/{moduleId}

Get one module with its lesson outline.

GET/v1/courses/{courseId}/modules/{moduleId}/lessons

List lessons for a module.

GET/v1/courses/{courseId}/modules/{moduleId}/lessons/{lessonId}

Get one lesson with content and activities.

Resources

21 tables

Aerospace resources such as launches, astronauts, missions, vehicles, organizations, and more.

Launches

Upcoming and previous launches cached from The Space Devs Launch Library 2.

Source and freshness

Data comes from The Space Devs Launch Library 2. AeroVia serves it from its cache. API requests do not proxy upstream.
Use AeroVia for a stable API feed. Use The Space Devs directly for advanced filters, historical queries, or the freshest data.

Launch Library 2Support The Space Devs
GET/v1/launches/upcoming

List upcoming launches.

GET/v1/launches/previous

List previous launches.

Astronauts

People who have flown in space or are tracked as astronauts.

GET/v1/astronauts

List Astronauts records.

GET/v1/astronauts/{id}

Get one Astronauts record by ID.

Missions

Mission records and linked mission details.

GET/v1/missions

List Missions records.

GET/v1/missions/{id}

Get one Missions record by ID.

Vehicles

Individual rockets, spacecraft, aircraft, and other tracked vehicles.

GET/v1/vehicles

List Vehicles records.

GET/v1/vehicles/{id}

Get one Vehicles record by ID.

Vehicle Families

Shared vehicle programs or families that group related vehicles.

GET/v1/vehicle-families

List Vehicle Families records.

GET/v1/vehicle-families/{id}

Get one Vehicle Families record by ID.

Agencies

Government and public space agencies.

GET/v1/agencies

List Agencies records.

GET/v1/agencies/{id}

Get one Agencies record by ID.

Companies

Private aerospace companies and commercial organizations.

GET/v1/companies

List Companies records.

GET/v1/companies/{id}

Get one Companies record by ID.

Organizations

Non-profit, research, and other aerospace organizations.

GET/v1/organizations

List Organizations records.

GET/v1/organizations/{id}

Get one Organizations record by ID.

Facilities

Spaceports, launch sites, research centers, museums, and related facilities.

GET/v1/facilities

List Facilities records.

GET/v1/facilities/{id}

Get one Facilities record by ID.

Gatherings

Conferences, meetups, workshops, expos, and other aerospace events.

GET/v1/gatherings

List Gatherings records.

GET/v1/gatherings/{id}

Get one Gatherings record by ID.

Timeline Events

Launches, EVAs, docking events, milestones, and other timeline records.

GET/v1/timeline-events

List Timeline Events records.

GET/v1/timeline-events/{id}

Get one Timeline Events record by ID.

Space Stations

Space station records, crews, and related station details.

GET/v1/space-stations

List Space Stations records.

GET/v1/space-stations/{id}

Get one Space Stations record by ID.

Universities

Universities and higher-education institutions relevant to aerospace.

GET/v1/universities

List Universities records.

GET/v1/universities/{id}

Get one Universities record by ID.

Student Teams

Student-led aerospace teams, clubs, and competition groups.

GET/v1/student-teams

List Student Teams records.

GET/v1/student-teams/{id}

Get one Student Teams record by ID.

Books

Aerospace books and reading references.

GET/v1/books

List Books records.

GET/v1/books/{id}

Get one Books record by ID.

Movies

Movies in the aerospace media catalog.

GET/v1/movies

List Movies records.

GET/v1/movies/{id}

Get one Movies record by ID.

Tv Series

TV series in the aerospace media catalog.

GET/v1/tv-series

List Tv Series records.

GET/v1/tv-series/{id}

Get one Tv Series record by ID.

Documentaries

Documentaries in the aerospace media catalog.

GET/v1/documentaries

List Documentaries records.

GET/v1/documentaries/{id}

Get one Documentaries record by ID.

Learning Resources

Learning materials outside the main course system.

GET/v1/learning-resources

List Learning Resources records.

GET/v1/learning-resources/{id}

Get one Learning Resources record by ID.

Games

Games related to aerospace.

GET/v1/games

List Games records.

GET/v1/games/{id}

Get one Games record by ID.

Fun Facts

Short aerospace facts and trivia.

GET/v1/fun-facts

List Fun Facts records.

GET/v1/fun-facts/{id}

Get one Fun Facts record by ID.

Dictionary Terms

Dictionary terms from AeroDictionary.com

GET/v1/dictionary-terms

List Dictionary Terms records.

GET/v1/dictionary-terms/{id}

Get one Dictionary Terms record by ID.

Forum

3 sections

Read-only community posts, comments, and public forum profile shapes.

Forum posts

Read-only community discussion posts with safe author summaries.

GET/v1/forum/posts

List forum posts with pagination and optional category, search, and sort filters.

GET/v1/forum/posts/{id}

Get one forum post by ID.

Forum comments

Read-only comments and replies for a given forum post.

GET/v1/forum/comments

List comments for a specific forum post.

GET/v1/forum/comments/{id}

Get one forum comment by ID.

Forum user profiles

Public forum profile data and contribution summaries for a user.

GET/v1/forum/users/{id}

Get the public forum profile for one user.

Account

1 section

Your API plan, remaining credits, usage reset date, and purchased add-ons.

Account usage

Current plan, included usage, and purchased credit-pack overview.

GET/v1/account/usage

Get the current account usage and credit overview.

Common errors

These are the main error shapes to handle before shipping an integration.

401 unauthorized

{
  "error": {
    "code": "unauthorized",
    "message": "A valid AeroVia API key is required."
  }
}

403 supporter required

{
  "error": {
    "code": "supporter_required",
    "message": "An active AeroVia supporter plan is required to use the API."
  }
}

403 insufficient credits

{
  "error": {
    "code": "insufficient_credits",
    "message": "No API credits remain for this account."
  }
}

404 not found

{
  "error": {
    "code": "not_found",
    "message": "Astronaut not found."
  }
}

Building against the API? Share what feels missing, unclear, or hard to integrate.