Seats Aero Partner CLI

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