Build in your language
Typed clients for the Partner API and the Earn sandbox, with a clear contract for each.
Choose TypeScript for an asynchronous JavaScript backend or Python for a synchronous service and reporting workflow. Both packages include separate Partner and Sandbox clients.
| TypeScript | Python | |
|---|---|---|
| Runtime | Node 18+ with fetch, ESM | Python 3.9+, synchronous |
| Partner client | PartnerClient |
PartnerClient |
| Sandbox client | SandboxClient |
SandboxClient |
| Types | Interfaces and schema types | TypedDict models and py.typed |
| Runtime dependencies | None | None |
| Guide | TypeScript | Python |
The review release is available as locally installable packages. It has not been published to npm or PyPI.
Choose the right client
PartnerClient connects to your assigned Partner API URL for attribution, balances, reporting and operations. It covers all 43 methods, including administrative methods with their own permissions.
SandboxClient uses the separate sandbox contract for simulated positions and customer journeys. The original Thesauros class name remains available for compatibility. Switching a key prefix does not switch an environment or convert one API into the other.
Common behavior
Methods return the response's data. Response metadata remains available separately on the client. GET requests can retry rate limits and server errors; writes are sent once so an uncertain response cannot silently repeat an operation. Webhook helpers verify the original body and offer timestamp checks.
Start with the language guide, then consult the method reference for parameters, permissions and response fields.