Python SDK

pip install signinid

from signinid import SigninID

# Set SIGNINID_SECRET_KEY environment variable
client = SigninID()

# Wait for a new verification email to arrive
email = client.inbox.wait_for_new(to="user@test.com")

# Extract the OTP
if email:
    print(f"Verification code: {email.detected_otp}")

import asyncio
from signinid import AsyncSigninID

async def main():
    async with AsyncSigninID(secret_key="sk_live_...") as client:
        email = await client.inbox.wait_for_new(to="user@test.com")
        if email:
            print(f"OTP: {email.detected_otp}")

asyncio.run(main())

# Using environment variable (recommended)
client = SigninID()

# Or pass secret key directly
client = SigninID(secret_key="sk_live_...")

import asyncio
from signinid import AsyncSigninID

async def main():
    async with AsyncSigninID() as client:
        # Wait for new email
        email = await client.inbox.wait_for_new(to="user@test.com")

        # Get latest
        email = await client.inbox.latest(to="user@test.com")

        # List and fetch
        inbox_ids = await client.inbox.list(to="user@test.com")
        for email_id in inbox_ids:
            full_email = await client.inbox.get(email_id)
            print(full_email.detected_otp)

asyncio.run(main())

from signinid import (
    SigninID,
    AuthenticationError,
    NotFoundError,
    ValidationError,
    RateLimitError,
    NetworkError,
    TimeoutError,
)

try:
    email = client.inbox.get("invalid-id")
except NotFoundError:
    print("Email not found")
except AuthenticationError:
    print("Invalid API key")
except ValidationError as e:
    print(f"Invalid parameters: {e.details}")
except RateLimitError as e:
    print(f"Rate limited. Retry after: {e.retry_after}s")
except NetworkError:
    print("Network error")
except TimeoutError:
    print("Request timed out")