Equineline APIequineline.com ↗

"""Walkthrough: Equineline SDK — search for a Thoroughbred, then fetch its full pedigree."""
from parse_apis.equineline_com_api import Equineline, HorseNotFound

client = Equineline()

# Search for horses matching a name; limit= caps total items returned.
match = client.horses.search(horse_name="Secretariat", limit=5).first()
if match is None:
    print("No horses found for that name.")
else:
    print(match.name, match.foaling_year, match.sex)

    # Use the reference_number from the search hit to fetch the full pedigree.
    try:
        pedigree = client.pedigrees.get(reference_number=match.reference_number)
    except HorseNotFound:
        print("Pedigree not available for this horse.")
    else:
        # Header facts
        profile = pedigree.horse
        print(f"{profile.name} ({profile.color} {profile.sex}), foaled {profile.foaled} in {profile.foaled_in}")
        print(f"Starts: {profile.starts}  Highlight: {profile.highlight}")
        print(f"Breeder: {pedigree.breeder}")

        # Dosage figures (may be absent for some horses)
        if pedigree.dosage_profile is not None:
            print(f"Dosage profile: {pedigree.dosage_profile}  DI: {pedigree.dosage_index}")

        # First-generation ancestors (sire and dam)
        for anc in pedigree.ancestors[:2]:
            print(f"  Gen {anc.generation} {anc.path}: {anc.display_name} ({anc.foaling_year})")

        # Nicking statistics when available
        if pedigree.nicking is not None:
            for stat in pedigree.nicking.stats:
                print(f"  {stat.title}: {stat.winners} winners from {stat.foals} foals, AEI {stat.ael}")

        # Most recent auction result when available
        if pedigree.most_recent_auction is not None:
            auction = pedigree.most_recent_auction
            print(f"Last sale: {auction.sale_price} at {auction.sale}")

print("exercised: horses.search / pedigrees.get")