Pa APIfile.dos.pa.gov ↗

"""Walkthrough: PA Business Entity Search — search, navigate, and inspect details."""
from parse_apis.file_dos_pa_gov_api import PaBusinessSearch, SearchType, EntityNotFound

client = PaBusinessSearch()

# Search for entities whose name starts with a keyword; cap total items.
for summary in client.entity_summaries.search(query="GOOGLE", search_type=SearchType.STARTS_WITH, limit=5):
    print(summary.entity_name, summary.entity_type, summary.standing)

# Drill into the first match's full details via summary-to-detail navigation.
hit = client.entity_summaries.search(query="GOOGLE", limit=1).first()
if hit is not None:
    detail = hit.details()
    print(detail.entity_name, detail.status, detail.jurisdiction)
    print("Business activity:", detail.business_activity)
    print("Formation:", detail.formation_date)

    # Walk nested typed objects: officers and filing history.
    for officer in detail.officers:
        print("  Officer:", officer.name, officer.role)
    for filing in detail.filing_history:
        print("  Filing:", filing.type, filing.date, filing.status)

    # Registered office address (nullable — guard before access).
    if detail.registered_office_address is not None:
        addr = detail.registered_office_address
        print("  Office:", addr.street, addr.city, addr.state, addr.postal_code)

# Point lookup by entity number discovered from a prior search result.
if hit is not None:
    try:
        entity = client.entities.get(entity_number=hit.entity_number)
        print(entity.entity_name, entity.standing, entity.term_of_duration)
    except EntityNotFound:
        print("Entity not found for", hit.entity_number)

print("exercised: entity_summaries.search / EntitySummary.details / entities.get")