SDK Overview
Five official SDKs. Python, TypeScript, Java, PHP and Ruby, each published to its language's package registry and generated from the same OpenAPI spec that produces this API reference.
Generating the SDKs from the spec keeps them in step with the API. Request and response types, enums and error shapes all come from it, so a new field reaches the SDK the same day it reaches the API, and no hand written client drifts out of date behind you.
Supported languages
pip install kintsugi-tax-platform-sdk
npm add @kintsugi-tax/tax-platform-sdk
com.trykintsugi:kintsugi-tax-java-sdk
composer require kintsugi-tax/tax-platform-sdk
gem install kintsugi_sdk
Packages
| Language | Package | Registry | Requires |
|---|---|---|---|
| Python | kintsugi-tax-platform-sdk | PyPI | 3.10+ |
| TypeScript | @kintsugi-tax/tax-platform-sdk | npm | see RUNTIMES.md |
| Java | com.trykintsugi:kintsugi-tax-java-sdk | Maven Central | JDK 11+ |
| PHP | kintsugi-tax/tax-platform-sdk | Packagist | PHP 8.2+ |
| Ruby | kintsugi_sdk | RubyGems | Ruby 3.2+ |
What you get
Coverage
Python, TypeScript, Java and PHP cover every endpoint in the API reference. Ruby covers part of it today: customers, transactions, exemptions, address validation, tax estimation, and some of nexus and products.
The Partner API is a separate surface. An SDK reaches a
partner endpoint only where that same endpoint also appears in the API
reference, which covers customers, transactions, exemptions,
filings, registrations, nexus, products, address validation and tax estimation.
Everything the Partner API adds beyond that sits outside the SDKs: all of the
partner specific /v2 endpoints, along with its additional /v1 endpoints for
organizations, users, API keys, connections, bank details, product configs,
filing generation and reports. Call those over HTTP.
You are never left guessing which is which. Every reference page carries a code sample in all five languages. Where an SDK covers the endpoint, the sample is that SDK's call, with its install line beside it. Where it does not, the sample is the same request written against the language's standard HTTP client, and the pane says so.
Getting started
Create one in the Kintsugi app. See Creating and managing API keys.
Take the package for your language from the table above.
Work through the Quick start, then the guide for your language.
Prefer plain HTTP? Every reference page has a cURL sample too, and Making an authenticated request walks through the raw request end to end.