Metadata-Version: 2.4
Name: orizn
Version: 1.0.0
Summary: Official Python SDK for the Orizn Visa API — 39,585 passport-destination pairs in 15 languages
Project-URL: Homepage, https://visa.orizn.app
Project-URL: Repository, https://github.com/MattJeff/orizn-py
Project-URL: Documentation, https://visa.orizn.app/visa-api/dashboard/docs
Project-URL: Issues, https://github.com/MattJeff/orizn-py/issues
Author-email: Orizn <api@orizn.app>
License-Expression: MIT
License-File: LICENSE
Keywords: api,immigration,orizn,passport,sdk,travel,visa
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.9
Requires-Dist: requests>=2.28.0
Description-Content-Type: text/markdown

# orizn

Official Python SDK for the [Orizn Visa API](https://visa.orizn.app).

Check visa requirements for **39,585 passport-destination pairs** in **15 languages**.

## Install

```bash
pip install orizn
```

## Quick start

```python
from orizn import Orizn

# No API key needed for quick checks
client = Orizn()
result = client.check("FRA", "JPN")
print(result.requirement)    # "visa_free"
print(result.visa_free_days) # 90

# Full details (get free key at visa.orizn.app)
client = Orizn(api_key="your-key")
visa = client.get_visa("USA", "CHN", lang="fr")
print(visa.documents_required)
print(visa.process)
print(visa.tips)
```

## Methods

| Method | Auth | Description |
|--------|------|-------------|
| `check(passport, destination)` | None | Quick visa check |
| `get_visa(passport, destination, lang?)` | Key | Full details |
| `bulk(passport, lang?)` | Key (Pro) | All destinations |
| `changes(passport?, destination?)` | Key (Starter) | Policy changes |
| `stats()` | None | Coverage stats |

## Links

- [Get free API key](https://visa.orizn.app)
- [API Docs](https://visa.orizn.app/visa-api/dashboard/docs)
- [MCP Server](https://github.com/MattJeff/orizn-mcp-server)
- [npm SDK](https://www.npmjs.com/package/orizn)
