Vairified Python SDK

Official Python SDK for the Vairified Partner API. Async-first, object-oriented design for easy integration with player ratings, search, and match submission.

Contents:

• Quick Start
  • Installation
  • Configuration
  • Basic Usage
  • Environment Selection
  • OAuth Connect Flow
  • Error Handling
• User Guide
  • Working with Members
  • Searching Players
  • Submitting Matches
  • Dry-Run Mode
  • Rating Updates
  • Webhook Testing
  • Advanced Configuration
  • OAuth Connect Flow
• API Reference
  • Client
  • Models
  • OAuth
  • Errors

Installation

Install from PyPI:

pip install vairified

Or with UV:

uv add vairified

Quick Example

import asyncio
from vairified import Vairified

async def main():
    async with Vairified(api_key="vair_pk_xxx") as client:
        member = await client.get_member("user_123")
        print(f"{member.name}: {member.rating}")

asyncio.run(main())

Features

• Async-first: Built on httpx for modern async/await patterns

• Object-oriented: Rich models with methods (member.refresh(), results.next_page())

• Type-safe: Full type hints for IDE autocompletion

• OAuth support: Full OAuth flow for player consent and token management

• Environment support: Switch between production, staging, and local environments

• Dry-run mode: Test integrations without affecting production data

Indices and tables

• Index

• Module Index

• Search Page