For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
      • AstroFully-managed data operations, powered by Apache Airflow.
      • Astro Private CloudRun Airflow-as-a-service in your environment.
      • Professional ServicesExpert Airflow services for your enterprise's success.
    • Tools
      • Cosmos
      • Orbiter
      • CLI
      • AI SDK
      • Agents
      • Blueprint
      • UpdatesThe State of Airflow 2026See the insights from over 5,800 data practitioners in the full report. Download Now ➔
  • Customers
  • Docs
    • Insights
      • Blog
      • Webinars
      • Resource Library
      • Events
    • Education
      • Academy
      • What is Airflow?
  • Pricing
Get Started Free
    • Astro CLI
    • Quickstart
    • CLI reference
      • astro completion
      • astro api
        • astro api airflow
        • astro api cloud
        • astro api registry
      • astro auth
      • astro config
      • astro context
      • astro dbt
      • astro deploy
      • astro deployment
      • astro dev
      • astro ide
      • astro login
      • astro logout
      • astro organization
      • astro otto
      • astro remote
      • astro run
      • astro team
      • astro telemetry
      • astro user create
      • astro version
      • astro workspace

Product

  • Platform Overview
  • Astro
  • Astro Observe
  • Astro Private Cloud
  • Security & Trust
  • Pricing

Tools & Services

  • Cosmos
  • Docs
  • Professional Services
  • Product Updates

Use Cases

  • AI Ops
  • Data Observability
  • ETL/ELT
  • ML Ops
  • Operational Analytics
  • All Use Cases

Industries

  • Financial Services
  • Gaming
  • Retail
  • Manufacturing
  • Healthcare
  • All Industries

Resources

  • Academy
  • eBooks & Guides
  • Blog
  • Webinars
  • Events
  • The Data Flowcast Podcast
  • All Resources

Airflow

  • What is Airflow
  • Airflow on Astro
  • Airflow 3.0
  • Airflow Upgrades
  • Airflow Use Cases
  • Airflow 2.x End of Life

Company

  • Our Story
  • Customers
  • Newsroom
  • Careers
  • Contact

Support

  • Knowledge Base
  • Status
  • Contact Support
GitHubYouTubeLinkedInx
  • Legal
  • Privacy
  • Terms of Service
  • Consent Preferences

  • Do Not Sell or Share My Personal information
  • Limit the Use Of My Sensitive Personal Information

Apache Airflow®, Airflow, and the Airflow logo are trademarks of the Apache Software Foundation. Copyright © Astronomer 2026. All rights reserved.

LogoLogo
CLI referenceastro api

astro api registry

Edit this page
Built with

Make HTTP requests to the Airflow Provider Registry API. No authentication is required.

The argument can be either:

  • A path of a registry API endpoint, such as /providers.json or /providers/amazon/modules.json
  • An operation ID from the API spec, such as listProviders or getProviderModulesLatest

The /api prefix is added automatically to paths. Use astro api registry ls to discover all available endpoints and operation IDs.

Usage

$astro api registry <endpoint | operation-id> [flags]

Commands

CommandDescription
lsList all available registry API endpoints. Supports an optional filter argument
describe <endpoint>Show details about an endpoint, including path parameters and response schema

Options

OptionDescriptionPossible Values
-F, --fieldAdd a typed parameter in key=value format.Any valid key-value pair
--generatePrint the equivalent curl command instead of executing the request.None
-H, --headerAdd an HTTP request header in key:value format.Any valid header
-i, --includeInclude HTTP response status line and headers in the output.None
--inputThe file to use as the body for the HTTP request. Use - for stdin.A valid file path
-q, --jqApply a jq filter to the response output.Any valid jq expression
-X, --methodThe HTTP method for the request. The default is GET.Any valid HTTP method
-p, --path-paramOverride a path parameter in key=value format. For use with operation IDs.A key-value pair such as providerId=amazon
-f, --raw-fieldAdd a string parameter in key=value format.Any valid key-value pair
--registry-urlOverride the registry base URL. Can also be set with the ASTRO_REGISTRY_URL environment variable.A valid URL
--silentSuppress response output.None
-t, --templateFormat the response using a Go template.Any valid Go template string
--verboseInclude full HTTP request and response in the output.None

Examples

$# List all available registry API endpoints
$astro api registry ls
$
$# Filter endpoints by keyword
$astro api registry ls providers
$
$# Query by operation ID with path parameters
$astro api registry getProviderModulesLatest -p providerId=amazon
$
$# Query by path
$astro api registry /providers.json
$
$# Use jq filter on response
$astro api registry /providers.json --jq '.providers[0].id'
$
$# Use Go template for output
$astro api registry listProviders \
> --template '{{range .providers}}{{.id}}{{"\n"}}{{end}}'
$
$# Generate curl command instead of executing
$astro api registry /providers.json --generate
$
$# Show full request and response details
$astro api registry /providers.json --verbose

Related Commands

  • astro api airflow
  • astro api cloud