verifiquemos 0.1.1

Official Python SDK for the Verifiquemos compliance API

verifiquemos

Official Python SDK for the Verifiquemos compliance API.

KYC, RENAP, OFAC, ONU, Lista Engel, PEP, CPE — Guatemala-specific compliance in one API call.

Install

pip install verifiquemos

Quickstart (sync)

from verifiquemos import VerifiquemosClient

with VerifiquemosClient(api_key="vfq_...") as client:
    me = client.auth.me()
    print(me["tenant"]["name"])

    # cui is NOT a parameter — it is extracted from the DPI via OCR.
    with open("dpi.jpg", "rb") as f:
        validation = client.validations.create(
            naturaleza_cliente="individual",
            dpi_file=f.read(),
            pais_origen_fondos="GTM",
        )
    print(f"Validation submitted: {validation['id']}")

Quickstart (async)

import asyncio
from verifiquemos import AsyncVerifiquemosClient

async def main():
    async with AsyncVerifiquemosClient(api_key="vfq_...") as client:
        me = await client.auth.me()
        print(me)

asyncio.run(main())

Error handling

from verifiquemos import ApiError, RateLimitError, NetworkError, VerifiquemosClient

with VerifiquemosClient(api_key="vfq_...") as client:
    try:
        client.validations.create(...)
    except RateLimitError as e:
        print(f"Retry after {e.retry_after_seconds}s")
    except ApiError as e:
        if e.is_payment_required:
            print("Buy more credits")
        else:
            raise
    except NetworkError:
        print("Connection failed")

Configuration

Argument	Default	Description
api_key	(required)	Server-issued API key. Starts with vfq_.
base_url	https://api.verifiquemos.gt	Override for staging/dev.
timeout	30.0	httpx timeout in seconds.

Documentation

• API reference: https://api.verifiquemos.gt/scalar
• Developer portal: https://verifiquemos.gt/developers

License

MIT