Skip to content
Documentation menu
Developer docs

SDKs

Official libraries from Orizn and a curated list of community ones.

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

Beta

Works in Node 18+, Bun, Deno, and modern browsers. Ships full TypeScript types and Zod schemas.

Install
bashinstall.sh
npm install @orizn/sdk
# or
pnpm add @orizn/sdk
yarn add @orizn/sdk
Example
typescriptexample.ts
import { 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

Beta

Sync and async clients on top of httpx. Pydantic models for full type-checking. Python 3.10+.

Install
bashinstall.sh
pip install orizn
# or
uv add orizn
Example
pythonexample.py
from orizn import Orizn

orizn = Orizn(api_key=os.environ["ORIZN_API_KEY"])

visa = orizn.visa.lookup(passport="FRA", destination="JPN")
print(visa.requirement)  # visa_free

Go

Coming soon

Context-aware client with built-in exponential backoff. Designed to drop into existing Go HTTP middleware stacks. Go 1.22+.

Install
bashinstall.sh
go get github.com/orizn-app/orizn-go
Example
goexample.go
client := 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_free

Community 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.

LanguagePackageAuthorNotes
Rubyorizn-rb@takahashiGem with idiomatic Faraday adapter. Rails-friendly.
PHPorizn-php@mariopalacioPSR-7 / Guzzle client.
Elixirorizn_ex@laurenthebertTesla-based, with Telemetry events.
Rustorizn-rs@kdoglioAsync (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.