Python SDK

from virtuous import Virtuous
client = Virtuous(token="YOUR_API_KEY")
# List contacts with auto-pagination
contacts = client.contacts_and_individuals.search_contacts(
    search="John",
    skip=0,
    take=25,
)
for contact in contacts:
    print(contact)
# Get a specific contact
contact = client.contacts_and_individuals.get_a_contact(contact_id="12345")

all_gifts = client.giving.query_gifts(
    groups=[{"column_name": "Amount", "operator": "GreaterThan", "value": "100"}],
)
for gift in all_gifts:
    print(gift)

client = Virtuous(
    token="YOUR_API_KEY",
    max_retries=5,
)

from virtuous import VirtuousError
try:
    contact = client.contacts_and_individuals.get_a_contact(contact_id="invalid-id")
except VirtuousError as e:
    print(e.status_code)
    print(e.message)

from virtuous import AsyncVirtuous
client = AsyncVirtuous(token="YOUR_API_KEY")
contacts = await client.contacts_and_individuals.search_contacts(search="John")
async for contact in contacts:
    print(contact)