Choose a client

Available clients

Install the official Node package @kuahr/node from npm or Python distribution kuahr from PyPI. Python keeps import kua; the unrelated PyPI project named kua is not this SDK.

What the clients handle

Both clients expose the company API resources: payroll drafts/listing, employee creation, events, webhooks, Test-data reset, leave, salary advances and performance. They set the API-key header, accept operation-specific idempotency options, map failures to KuaError, and provide raw-body signature-verification helpers.

They do not automatically retry, provision an employment type or salary, approve payroll, manage a general wallet or exchange Kola OIDC codes. Registered-client OIDC uses the separate HTTP flow. Signing-secret rotation is a dashboard action, not an SDK method.

Use one API address

Both clients call https://api.kuahr.com/v1 by default. Use a Test key for supported isolated records and switch to a Live key when ready for live company data. The URL stays the same. See Test and Live keys.

Keep versions deliberate

The public SDK source is kuahr/kua-sdk. Review and record the source revision you install, pin the dependency in your application and run your integration checks before upgrading. The current release is 0.3.3 in both registries. Review versioning, release notes, and the go-live checklist.

Public source, private product code

The Kua GitHub organisation publishes only reviewed SDK client code, examples and synthetic tests. You do not need access to any private product or documentation repository. Download or clone the public SDK source using the language guides above. Package releases are maintained from that public repository.