Seats.aero Partner API for award travel availability, cached search, route lists, and trip revalidation details.
Created by @cathrynlavery (Cathryn Lavery).
Quick Start
1. Install
See Install above.
2. Set Up Credentials
Get your API key from your API provider's developer portal. The key typically looks like a long alphanumeric string.
export SEATS_AERO_API_KEY="***"
SEATS_AERO_PARTNER_PARTNER_AUTHORIZATION is also supported for generator compatibility. You can persist the key in ~/.config/seats-aero-pp-cli/config.toml.
3. Verify Setup
seats-aero-pp-cli doctor
This checks your configuration and credentials.
4. Try Your First Command
seats-aero-pp-cli routes
Usage
Run seats-aero-pp-cli --help for the full command reference and flag list.
Commands
availability
Manage availability
seats-aero-pp-cli availability bulk - Retrieve bulk availability for all tracked routes in a mileage program.
routes
Manage routes
seats-aero-pp-cli routes get - Get all origin-destination routes tracked for a mileage program.
seats-aero-partner-search
Manage seats aero partner search
seats-aero-pp-cli seats-aero-partner-search cached-search - Search Seats.aero cached award availability between an origin and destination.
trips
Manage trips
seats-aero-pp-cli trips get - Get detailed trip information by revalidation/trip ID from search or availability results.
Output Formats
# Human-readable table (default in terminal, JSON when piped)
seats-aero-pp-cli routes
# JSON for scripting and agents
seats-aero-pp-cli routes --json
# Filter to specific fields
seats-aero-pp-cli routes --json --select id,name,status
# Dry run — show the request without sending
seats-aero-pp-cli routes --dry-run
# Agent mode — JSON + compact + no prompts in one flag
seats-aero-pp-cli routes --agent
Agent Usage
This CLI is designed for AI agent consumption:
- Non-interactive - never prompts, every input is a flag
- Pipeable -
--json output to stdout, errors to stderr
- Filterable -
--select id,name returns only fields you need
- Previewable -
--dry-run shows the request without sending
- Read-only by default - this CLI does not create, update, delete, publish, send, or mutate remote resources
- Offline-friendly - sync/search commands can use the local SQLite store when available
- Agent-safe by default - no colors or formatting unless
--human-friendly is set
Exit codes: 0 success, 2 usage error, 3 not found, 4 auth error, 5 API error, 7 rate limited, 10 config error.
Health Check
seats-aero-pp-cli doctor
Verifies configuration, credentials, and connectivity to the API.
Configuration
Config file: ~/.config/seats-aero-pp-cli/config.toml
Environment variables:
| Name | Kind | Required | Description |
|---|
SEATS_AERO_PARTNER_PARTNER_AUTHORIZATION | per_call | Yes | Set to your API credential. |
Troubleshooting
Authentication errors (exit code 4)
- Run
seats-aero-pp-cli doctor to check credentials
- Verify the environment variable is set:
echo $SEATS_AERO_API_KEY
Not found errors (exit code 3)
- Check the resource ID is correct
- Run the
list command to see available items
Generated by CLI Printing Press