vihaya-events 0.1.0

Official Python SDK for the Vihaya Events platform. Fetch events, register attendees, and verify Razorpay payments with a fully-typed client.

Vihaya Events — Python SDK

The official Python SDK for the Vihaya Events platform. Fully typed, built on httpx and Pydantic v2, with feature parity across our JavaScript and Flutter SDKs.

Install

pip install vihaya-events

Requires Python 3.9+.

Quick start

from vihaya import Vihaya

vh = Vihaya("vh_live_...")  # get your key from the developer dashboard

for event in vh.events.list():
    print(f"{event.title} — {event.location}")

Use it as a context manager to guarantee the connection pool gets closed:

with Vihaya("vh_live_...") as vh:
    event = vh.events.get("evt_8x42j9")
    print(event.title, event.date)

Fetch a full event

events.get() returns an Event with every piece of metadata the organizer has configured — speakers, agenda, sponsors, FAQs, custom fields, pricing tiers, and sub-events for mega events.

event = vh.events.get("evt_8x42j9")

print(event.title)
print(f"Mode: {event.event_mode}  Timezone: {event.timezone}")

for speaker in event.speaker_list or []:
    print(f"- {speaker.name} ({speaker.role})")

for item in event.agenda_list or []:
    print(f"[{item.time}] {item.title}")

for tier in event.special_prices or []:
    print(f"  {tier.name}: ₹{tier.amount}")

Mega events

If event.event_type == "megaEvent", it contains sub-events. Each sub-event has its own tiers, custom fields, etc.

if event.event_type == "megaEvent":
    for sub in event.sub_events or []:
        price = "Free" if sub.is_free else f"₹{sub.price}"
        print(f"- {sub.title} ({price})")

Register an attendee

from vihaya import RegisterData

registration = RegisterData(
    name="Anjali Mehta",
    email="[e-mail]",
    phone="[phone]",
    custom_fields={"T-Shirt Size": "L", "College": "Vihaya Institute"},
)

result = vh.events.register("evt_8x42j9", registration)

if result.get("isPaid"):
    order_id = result["orderId"]
    # Launch Razorpay checkout with this order_id, then verify server-side:
    vh.payments.verify(
        payment_id="pay_xxx",
        order_id=order_id,
        signature="sig_xxx",
    )
else:
    print(f"Registered! ID: {result['registrationId']}")

You can also pass a plain dict instead of RegisterData if you prefer.

Error handling

All API failures raise VihayaError with the status code and raw body:

from vihaya import VihayaError

try:
    vh.events.get("evt_does_not_exist")
except VihayaError as exc:
    print(f"{exc.message} (status={exc.status})")
    print(exc.data)

API reference

Vihaya(api_key, *, base_url=..., headers=..., timeout=30.0)

The main client. All arguments after api_key are keyword-only.

vh.events

Method	Returns	Description
list()	list[Event]	All events on the authenticated account.
get(event_id)	Event	Full metadata for one event.
register(event_id, data)	dict	Submit a registration. data can be RegisterData or dict.

vh.payments

Method	Returns	Description
verify(*, payment_id, order_id, signature, amount=None)	dict	Server-side Razorpay signature verification.

Security: never hard-code a live secret key in client-side code. Use environment variables and perform payment verification from a trusted backend environment only.

Development

git clone https://github.com/Vishnu252005/vihaya-sdk-python.git
cd vihaya-sdk-python
pip install -e ".[dev]"
pytest

License

MIT — see LICENSE.