Acura APIacura.ca ↗

"""Walkthrough: Acura Canada Deals & Offers API — bounded, re-runnable."""
from parse_apis.acura_canada_deals_offers_api import (
    AcuraCanada, Province, PaymentMethod, Language, InvalidInput
)

client = AcuraCanada()

# List all models with their trims and pricing
for model in client.models.list(language=Language.EN, limit=5):
    print(model.name, model.year, model.categories)
    for trim in model.trims[:2]:
        print(f"  {trim.display_name} — ${trim.transmissions[0].msrp}")

# Get current offers for a specific province
offer = client.offers.list(model="mdx", province=Province.ON, limit=3).first()
if offer:
    print(offer.model_name, offer.model_year, offer.province)
    for inc in offer.lease_incentives:
        print(f"  Lease incentive: {inc.name} — ${inc.value}")

# Calculate a lease payment using keys from the catalog
first_model = client.models.list(limit=1).first()
if first_model:
    trim = first_model.trims[0]
    tx = trim.transmissions[0]
    try:
        payment = client.payments.calculate(
            model_key=first_model.model_key,
            trim_key=trim.trim_key,
            transmission_key=tx.transmission_key,
            province=Province.BC,
            payment_method=PaymentMethod.LEASE,
            term=36,
        )
        print(payment.payment_method, payment.term, payment.apr)
        print(f"  Monthly: ${payment.gross_payment_amount}, MSRP: ${payment.msrp}")
        print(f"  Offer period: {payment.offer_period.start_date} to {payment.offer_period.end_date}")
    except InvalidInput as exc:
        print(f"Invalid input: {exc}")

print("exercised: models.list / offers.list / payments.calculate")