Unofficial · community-maintained

Every Nomba endpoint, already wired.

nomba-rs is a Rust SDK built from Nomba's OpenAPI spec — 15 resource groups, dual sync/async APIs, with typed responses and request validation built in. No endpoint URLs to memorize, no manual token handling, no guessing field names.

cargo add nomba-rs
# or
# [dependencies]
# nomba-rs = "0.2"
# nomba-rs = { version = "0.2", features = ["async", "validation"] }  # optional features
use nomba_rs::{Nomba, NombaClientConfig};

fn main() -> nomba_rs::Result<()> {
    let nomba = Nomba::new(
        "your_client_id",
        "your_client_secret",
        "your_account_id",
    )?;

    // Create a virtual account
    let account = nomba.virtual_accounts.create_virtual_account(
        "ref-123",
        "Jane Doe",
        None, None, None
    )?;

    println!("Created account: {:?}", account.data.account_ref);
    Ok(())
}

What's covered

Why generated, not hand-written

Every resource method, its required and optional fields, and its response shape come straight from Nomba's published OpenAPI spec — not transcribed by hand. That means field names match exactly (accountRef, not a guess at account_ref), and nested request bodies are checked locally against the same spec before anything goes over the network.

Scope

This SDK is unofficial and not affiliated with Nomba. It wraps Nomba's public API; see developer.nomba.com for the canonical reference and your dashboard credentials.

New in v0.2.0

Cleanup release: simpler gather_limited(calls, limit) signatures, an AsyncPaginator that works with plain async move blocks, validation coverage for the current /v2/bill/* routes, and working pagination examples. Upgrading from 0.1.x means dropping the third return_exceptions argument — see the changelog.

nomba-rust · unofficial Rust SDK Get started · API reference