Node.js
@komerza/node covers every endpoint in this reference, with typed models, typed errors, pagination and automatic retries. It needs Node 22 or later, and works from ESM and CommonJS.
Each group of endpoints in this reference is a property of the client, such as komerza.orders or komerza.webhooks, and each endpoint is a method on it. IDs come first, in the order the path takes them.
Lists
List methods return a page. Iterate it with for await to walk every item, fetching the next page as you go:
Errors
A failed call throws. Failures the API reports are an APIError, with a subclass for each status: ValidationError and BadRequestError for 400, AuthenticationError for 401, PermissionDeniedError for 403, NotFoundError for 404, ConflictError for 409, RateLimitError for 429 and InternalServerError for 5xx. Each carries the API’s error code, the rejected invalidFields, and the requestId to quote to support.
Retries and timeouts
Rate-limited calls are retried, honouring Retry-After up to a minute. Server errors, timeouts and dropped connections are retried for GET and DELETE only, since repeating a POST or PUT could apply it twice, and a refund is never retried unless you ask. Calls time out after 60 seconds. Change either for the client or for one call:
The full guide is in the README on GitHub.
Other languages
There’s no official SDK for other languages yet. Every endpoint is plain HTTPS with JSON bodies, so any HTTP client works: the Quick Start walks through a first request.Last modified on October 15, 2026