You can call the Orizn API directly with any HTTP client, but the official SDKs save you from re-implementing the boring bits: authentication, retries on transient 5xx errors, webhook signature verification, and fully-typed responses.
Official SDKs
First-party libraries maintained by the Orizn team. They follow semver, ship within 24h of any API change, and are covered by the same SLA as the API itself.
JavaScript / TypeScript
BetaWorks in Node 18+, Bun, Deno, and modern browsers. Ships full TypeScript types and Zod schemas.
npm install @orizn/sdk
# or
pnpm add @orizn/sdk
yarn add @orizn/sdkimport { Orizn } from "@orizn/sdk";
const orizn = new Orizn({ apiKey: process.env.ORIZN_API_KEY! });
const visa = await orizn.visa.lookup({
passport: "FRA",
destination: "JPN",
});
if (visa.requirement !== "visa_free") {
// guard your booking flow
}Python
BetaSync and async clients on top of httpx. Pydantic models for full type-checking. Python 3.10+.
pip install orizn
# or
uv add oriznfrom orizn import Orizn
orizn = Orizn(api_key=os.environ["ORIZN_API_KEY"])
visa = orizn.visa.lookup(passport="FRA", destination="JPN")
print(visa.requirement) # visa_freeGo
Coming soonContext-aware client with built-in exponential backoff. Designed to drop into existing Go HTTP middleware stacks. Go 1.22+.
go get github.com/orizn-app/orizn-goclient := orizn.New(os.Getenv("ORIZN_API_KEY"))
visa, err := client.Visa.Lookup(ctx, orizn.VisaLookupParams{
Passport: "FRA",
Destination: "JPN",
})
if err != nil {
return err
}
fmt.Println(visa.Requirement) // visa_freeCommunity SDKs
Built and maintained by the community — not part of the Orizn SLA, but battle-tested by their authors' own production traffic. If you ship one that's missing here, open a PR and we'll add it.
| Language | Package | Author | Notes |
|---|---|---|---|
| Ruby | orizn-rb | @takahashi | Gem with idiomatic Faraday adapter. Rails-friendly. |
| PHP | orizn-php | @mariopalacio | PSR-7 / Guzzle client. |
| Elixir | orizn_ex | @laurenthebert | Tesla-based, with Telemetry events. |
| Rust | orizn-rs | @kdoglio | Async (Tokio) and blocking variants. serde-driven types. |
Contributing
Spotted a bug in an official SDK? File an issue against the repo (links above) or email [email protected]. We label good first issues and triage within one business day.
Want to build a community SDK for a language not listed here? The API reference is the source of truth; if the answer to any question is unclear there, that's a docs bug we want to know about.