Node.js

30-second example

import { Postio } from '@postio/node';

const postio = new Postio({ apiKey: process.env.POSTIO_API_KEY });

const { results } = await postio.address.search({ q: '57 wimpole street' });
console.log(results[0].suggestion);
// → 57 Wimpole Street, London, W1G 8YW

Other server sdks

• PythonSync + async (PostioClient + AsyncPostioClient), Pydantic v2 models, typed exception hierarchy. Python 3.10+.
• GoStdlib net/http, zero runtime dependencies. Functional options, typed errors, retry-with-jitter. Go 1.22+.
• PHPSync, Guzzle 7 transport (BYO ClientInterface), readonly value objects, typed exception hierarchy. PHP 8.1+.
• RubySync, stdlib net/http (zero runtime gems), Data.define value classes, typed error hierarchy. Ruby 3.2+.
• .NETAsync-first via HttpClient, immutable record types, typed exceptions. .NET 8 LTS.