Seats.aero Partner API for award travel availability, cached search, route lists, and trip revalidation details.
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