KintsugiKintsugi
API reference

Tenanted API reference

Every Kintsugi Tenanted API endpoint in the 2026-07-21 release, generated directly from our OpenAPI spec so the reference always matches production.

2026-07-21275 endpointsUpdated from production

Versioning

The Tenanted API is versioned by release date. Choose a release with the Api-Version header, written as YYYY-MM-DD, and send it with every request. Paths carry no version prefix.

GET /transactions
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"

The header is optional. A request without it runs against 2026-07-21, the launch release, and a newer release never changes that default. Moving from v1? See what changed in 2026-07-21.

Addresses

GETPreview addresses eligible for batch approval
/addresses/approval-preview
POSTBatch-approve addresses
/addresses/approve
GETSuggest a fill for one blank address
/addresses/blank-suggestion
POSTAssign the business address to blank transactions
/addresses/bulk-assign-business-address
POSTFill the organization's blank-address transactions
/addresses/fill-blank
GETCount addresses needing attention
/addresses/needs-attention-summary
PUTRe-queue invalid-address transactions for validation
/addresses/revalidation
POSTSuggest addresses for a partial input
/addresses/suggestions
POSTSuggest addresses for many inputs
/addresses/suggestions/bulk
GETSummarize addresses by verification status
/addresses/summary
PUTUpdate transaction addresses in a batch
/addresses/transactions
POSTValidate and enrich an address
/addresses/validate

API Keys

GETList API keys
/api-keys
POSTCreate an API key
/api-keys
PATCHUpdate an API key
/api-keys/{api_key_id}
DELETERevoke an API key
/api-keys/{api_key_id}

Attachments

GETList attachments for a related entity
/attachments
POSTUpload an attachment
/attachments
GETGet an attachment by id
/attachments/{attachment_id}
GETDownload an attachment
/attachments/{attachment_id}/download

Billing

GETGet the organization's chargebee subscription
/billing
PATCHUpdate the organization's billing contact email
/billing
GETGet the organization's billing history chart
/billing/analytics
POSTStart a hosted chargebee checkout
/billing/checkout
GETGet the organization's billing-lock detail
/billing/details
GETGet the current month's billing estimate
/billing/estimate
GETList the organization's invoices
/billing/invoices
GETDownload one invoice as a PDF
/billing/invoices/{invoice_id}/pdf
GETGet usage detail for one invoice
/billing/invoices/{invoice_id}/usage
PATCHUpdate the organization's subscription plan
/billing/plan
POSTCreate a chargebee self-serve customer portal session
/billing/portal-session
GETGet unbilled usage since the last invoice
/billing/unbilled-usages

Certificate Imports

GETList certificate imports by review status
/certificate-imports
POSTApprove multiple certificate imports
/certificate-imports/bulk-approve
POSTConfirm a bulk certificate upload
/certificate-imports/confirm-upload
GETList certificate imports by upload session
/certificate-imports/sessions/{upload_session_id}
POSTInitiate a bulk certificate upload
/certificate-imports/upload-urls
POSTApprove a certificate import
/certificate-imports/{certificate_import_id}/approve
GETGet a certificate import's file URL
/certificate-imports/{certificate_import_id}/file-url
POSTReject a certificate import
/certificate-imports/{certificate_import_id}/reject

Compliance Documents

GETList compliance document catalog
/compliance-documents
PUTReplace one file under a many-file compliance document type
/compliance-documents/files/{document_id}
GETPreview a compliance document file
/compliance-documents/files/{document_id}/preview
POSTAdd a file to a many-file compliance document type
/compliance-documents/{catalog_type}
PUTAdd or replace a one-file compliance document
/compliance-documents/{catalog_type}

Connections

GETList connections
/connections
POSTStart an acumatica oauth connect
/connections/acumatica/oauth/authorize
POSTStart an airwallex oauth connect
/connections/airwallex/oauth/authorize
POSTActivate an apideck-backed connection
/connections/apideck/{conn_id}/activate
GETOpen an apideck vault session to edit a connection
/connections/apideck/{conn_id}/session
POSTConnect an apideck-backed service
/connections/apideck/{service_id}/connect
POSTConnect a bill.com account
/connections/bill-com/connect
POSTValidate bill.com credentials
/connections/bill-com/validate
POSTEnable tax collection on a bill.com connection
/connections/bill-com/{conn_id}/enable-tax
POSTConnect a bunny account
/connections/bunny/connect
PATCHRefresh a bunny connection's access token
/connections/bunny/{conn_id}/refresh
POSTConnect a campfire account
/connections/campfire/connect
POSTValidate campfire credentials
/connections/campfire/validate
PATCHUpdate a campfire connection's webhook signing secret
/connections/campfire/{conn_id}/webhook-secret
POSTConnect a chargebee account
/connections/chargebee/connect
POSTConnect a checkoutchamp account
/connections/checkoutchamp/connect
GETSummarize collected-tax tracking across your connections
/connections/collecting-summary
POSTStart an ebay oauth connect
/connections/ebay/oauth/authorize-request
GETGet ebay runame portal urls
/connections/ebay/oauth/setup
POSTStart a freshbooks oauth connect
/connections/freshbooks/oauth/authorize-request
GETList freshbooks businesses awaiting selection
/connections/freshbooks/oauth/businesses
POSTFinish connecting a freshbooks business
/connections/freshbooks/oauth/connect
POSTEnable tax collection on a freshbooks connection
/connections/freshbooks/{conn_id}/enable-tax
POSTConnect a hyperline account
/connections/hyperline/connect
POSTValidate hyperline credentials
/connections/hyperline/validate
POSTConnect a kill bill account
/connections/killbill/connect
POSTValidate kill bill credentials
/connections/killbill/validate
PATCHUpdate a kill bill connection's HMAC secret
/connections/killbill/{conn_id}/hmac-secret
POSTConnect a maxio account
/connections/maxio/connect
GETPoll an oauth connection-creation status
/connections/oauth-creation-status/{key}
POSTConnect an odoo account
/connections/odoo/connect
POSTValidate odoo credentials
/connections/odoo/validate
PATCHUpdate an odoo connection's HMAC secret
/connections/odoo/{conn_id}/hmac-secret
POSTConnect a kong konnect metering & billing organization
/connections/openmeter/connect
POSTValidate a konnect personal access token
/connections/openmeter/validate
GETRead openmeter connection fields for re-auth
/connections/openmeter/{conn_id}
POSTConnect an orb account
/connections/orb/connect
POSTConnect an ordway account
/connections/ordway/connect
POSTGenerate an ordway webhook secret
/connections/ordway/{conn_id}/webhook-secret/generate
POSTConnect a plentyone account
/connections/plentyone/connect
POSTValidate plentyone credentials
/connections/plentyone/validate
POSTDisconnect a quickbooks connection
/connections/quickbooks/disconnect
POSTConnect a recurly account
/connections/recurly/connect
POSTValidate recurly credentials
/connections/recurly/validate
POSTConnect a rillet account
/connections/rillet/connect
PATCHUpdate a rillet connection's webhook signing token
/connections/rillet/{conn_id}/webhook-token
POSTConnect a shopify account manually
/connections/shopify/connect
POSTComplete a shopify oauth connection
/connections/shopify/oauth/connect
POSTStart a SHOPLINE oauth connect
/connections/shopline/oauth/authorize
POSTConnect a stripe account through the stripe app
/connections/stripe/app-connect
POSTConnect a stripe account
/connections/stripe/connect
POSTConnect a vertex o-series account
/connections/vertex-o-series/connect
GETGet a vertex o-series connection's install credentials
/connections/vertex-o-series/{conn_id}/credentials
POSTMark a vertex o-series connection as installed
/connections/vertex-o-series/{conn_id}/mark-installed
POSTConnect a zenskar account
/connections/zenskar/connect
POSTConnect a zuora account
/connections/zuora/connect
POSTValidate zuora credentials
/connections/zuora/validate
PATCHSave zuora L2 tax setup
/connections/zuora/{conn_id}/tax-setup
GETGet a connection by id
/connections/{conn_id}
DELETEDelete a connection
/connections/{conn_id}
POSTActivate a connection
/connections/{conn_id}/activate
POSTRecord a connection's native-tax-disabled attestation
/connections/{conn_id}/attest
POSTConfirm collected-tax mode for registrations on a connection
/connections/{conn_id}/confirm-collecting
POSTDeactivate a connection
/connections/{conn_id}/deactivate
POSTDisable tax collection on a connection
/connections/{conn_id}/disable-tax-collection
POSTEnable tax collection on a connection
/connections/{conn_id}/enable-tax-collection
GETGet a connection's L2 enablement readiness
/connections/{conn_id}/l2-readiness
GETList a connection's unconfirmed collecting registrations
/connections/{conn_id}/pending-states
PATCHUpdate a connection's settings
/connections/{conn_id}/settings
POSTResync a connection
/connections/{conn_id}/sync
DELETEArchive an archived connection's transactions
/connections/{conn_id}/transactions
GETGet a connection's collected-tax comparison
/connections/{conn_id}/view-details

Credits

GETList credits
/credits
POSTCreate a credit
/credits

Customers

GETList customers
/customers
POSTCreate a customer
/customers
GETGet a customer by id
/customers/{customer_id}
PATCHUpdate a customer
/customers/{customer_id}
DELETEArchive a customer
/customers/{customer_id}
POSTUpsert a customer tax registration by tax id
/customers/{customer_id}/tax-registrations

Exemption Requests

GETList exemption requests
/exemption-requests
POSTCreate an exemption request
/exemption-requests
GETGet pre-send exemption-request conflicts for a customer
/exemption-requests/conflicts
GETList an exemption request's certificates
/exemption-requests/{request_id}/certificates
POSTMark an exemption request completed
/exemption-requests/{request_id}/mark-completed
POSTResend an exemption request's upload link
/exemption-requests/{request_id}/resend
POSTSend an exemption-request reminder
/exemption-requests/{request_id}/send-reminder

Exemption Requests (Public)

GETGet the status of a public exemption request
/public/exemption-requests/{token}
POSTConfirm uploaded certificates for an exemption request
/public/exemption-requests/{token}/confirm-upload
POSTRequest presigned upload urls for an exemption request
/public/exemption-requests/{token}/upload-urls

Exemptions

GETList exemptions
/exemptions
POSTCreate an exemption
/exemptions
POSTCreate many exemptions
/exemptions/bulk
GETList customers missing certificates
/exemptions/missing-certificates
POSTSend missing-certificate requests
/exemptions/missing-certificates/bulk-send
GETMissing-certificate metrics
/exemptions/missing-certificates/metrics
POSTUpload a certificate for a customer
/exemptions/missing-certificates/{customer_id}/upload
GETPoll a customer's certificate upload status
/exemptions/missing-certificates/{customer_id}/upload-status/{upload_session_id}
GETGet an exemption by id
/exemptions/{exemption_id}
PATCHUpdate an exemption
/exemptions/{exemption_id}
DELETEArchive an exemption
/exemptions/{exemption_id}
POSTUpload an exemption certificate
/exemptions/{exemption_id}/certificates
GETDownload an exemption certificate
/exemptions/{exemption_id}/certificates/{certificate_id}

Experience

GETDashboard task counts
/dashboard/tasks
GETOnboarding step completion status
/onboarding/steps-status

Filings

GETList filings
/filings
POSTRequest back-filings
/filings/backFilingRequest
GETList back-filing request options
/filings/backFilingRequest/options
GETGet the current back-filing terms
/filings/backFilingTerms/current
POSTApprove filings in bulk
/filings/bulk/approve
POSTPause filings in bulk
/filings/bulk/pause
GETList filing jurisdictions
/filings/jurisdictions
GETSummarize filings
/filings/summary
GETGet a filing by id
/filings/{filing_id}
POSTApprove a filing
/filings/{filing_id}/approve
GETList a filing's deferred transactions
/filings/{filing_id}/deferredTransactions
POSTPause a filing
/filings/{filing_id}/pause

Imports

GETList imports
/imports
POSTCreate an import and get a single-file upload URL
/imports/initiate
GETDownload a CSV import template
/imports/template
POSTCreate upload targets for one or more CSV files
/imports/upload-urls
POSTValidate a CSV file
/imports/validate
GETGet an import by id
/imports/{import_id}
GETGet a download link for an import's error artifact
/imports/{import_id}/error-file
POSTImport the validated rows
/imports/{import_id}/ingest
POSTStart processing an uploaded import
/imports/{import_id}/submit

Marketplaces

GETList marketplaces
/marketplaces
GETGet a marketplace by id
/marketplaces/{marketplace_id}
PATCHUpdate a marketplace's confirmation status
/marketplaces/{marketplace_id}
GETList transactions matched to a marketplace
/marketplaces/{marketplace_id}/transactions
POSTMark every matched transaction as a marketplace sale
/marketplaces/{marketplace_id}/transactions/mark-as-marketplace

Missing Certificates (Public)

GETGet the status of a public missing-certificate request
/public/exemption-requests/{token}/missing-certificates
POSTConfirm uploaded certificates for a missing-certificate request
/public/exemption-requests/{token}/missing-certificates/confirm-upload
POSTRequest presigned upload urls for a missing-certificate request
/public/exemption-requests/{token}/missing-certificates/upload-urls

Nexus

GETList nexus determinations
/nexus
POSTExport nexus report
/nexus/reports/export
GETGet a nexus determination
/nexus/{nexus_id}
POSTDisregard a nexus
/nexus/{nexus_id}/disregard
GETList a nexus's exposure history
/nexus/{nexus_id}/exposure-history
POSTResolve a nexus's collected-tax exposure
/nexus/{nexus_id}/resolve-collected-transactions

Organization Settings

GETGet organization settings
/organization-settings
PATCHUpdate organization settings
/organization-settings
GETGet exemption-reminder settings
/organization-settings/exemption-reminders
PATCHUpdate exemption-reminder settings
/organization-settings/exemption-reminders

Organizations

GETGet organization details
/organization-details
PATCHUpdate organization details
/organization-details
GETList organizations
/organizations
POSTCreate an organization
/organizations
GETSummarize your organizations
/organizations/summary
GETGet an organization by id
/organizations/{org_id}
PATCHUpdate an organization
/organizations/{org_id}
POSTArchive an organization
/organizations/{org_id}/archive

Physical nexus

GETList physical presences
/physical-nexus
POSTRecord a physical presence
/physical-nexus
GETList the physical presence category catalog
/physical-nexus/categories
GETGet a physical presence
/physical-nexus/{physical_nexus_id}
PATCHUpdate a physical presence
/physical-nexus/{physical_nexus_id}
DELETEDelete a physical presence
/physical-nexus/{physical_nexus_id}

Products

GETList products
/products
POSTCreate a product
/products
POSTApprove partially-approved products in bulk
/products/bulk-approve
POSTApprove partially-approved products by category
/products/bulk-approve-by-category
GETGet the resolved organization's in-progress bulk-classification import
/products/bulk-classifications/active-review
POSTCancel a bulk-classification import
/products/bulk-classifications/{import_id}/cancel
POSTConfirm a bulk-classification import
/products/bulk-classifications/{import_id}/confirm
GETGet a bulk-classification import's before/after preview
/products/bulk-classifications/{import_id}/preview
GETGet a bulk-classification import's rejected-rows file
/products/bulk-classifications/{import_id}/rejected-file
GETGet a bulk-classification import's review state
/products/bulk-classifications/{import_id}/review
POSTQueue products for reclassification
/products/bulk-classify
GETList the product category catalog
/products/categories
POSTCategorize and approve products
/products/categorize-approve
GETSummarize product classification progress
/products/classification-progress
GETCheck whether bulk classification can run
/products/classification-status
GETList product configurations
/products/configs
POSTCreate a product configuration
/products/configs
GETList blocklisted product codes
/products/configs/blocklist
POSTAdd a product code to the blocklist
/products/configs/blocklist
DELETERemove a product code from the blocklist
/products/configs/blocklist/{product_code_name}
POSTCreate product configurations in bulk
/products/configs/bulk
GETGet a product configuration by id
/products/configs/{config_id}
PATCHUpdate a product configuration
/products/configs/{config_id}
DELETEDelete a product configuration
/products/configs/{config_id}
GETBreak down products by category
/products/overview
POSTRecategorize products in bulk
/products/recategorize
POSTExport products
/products/reports/export
GETSummarize products by status
/products/summary
GETGet a product by id
/products/{product_id}
PATCHUpdate a product
/products/{product_id}
DELETEArchive a product
/products/{product_id}

Registrations

GETGet a jurisdiction's registration form
/registration-jurisdiction-fields
GETList registration jurisdictions
/registration-jurisdictions
POSTPreview registering a jurisdiction
/registration-preflights
GETList registrations
/registrations
POSTCreate a registration
/registrations
GETSummarize registrations by status
/registrations/summary
GETGet a registration by id
/registrations/{registration_id}
PATCHUpdate a registration
/registrations/{registration_id}
POSTUpload an attachment for a registration
/registrations/{registration_id}/attachments
PUTSet a registration's credentials
/registrations/{registration_id}/credentials
POSTReveal a registration's credentials
/registrations/{registration_id}/credentials/reveal
POSTDeregister a registration
/registrations/{registration_id}/deregister
GETList a registration's OSS countries
/registrations/{registration_id}/oss-countries
POSTEmail a registration's password to yourself
/registrations/{registration_id}/send-password

Reports

POSTStart a report job
/reports/jobs
GETGet a report job's status
/reports/jobs/{report_job_id}
GETGet a report job's download link
/reports/jobs/{report_job_id}/download

Reports (Public)

GETDownload a report via an emailed link
/public/reports/downloads/{download_token}

Tax Estimations

POSTEstimate tax on a transaction
/tax-estimations

Transactions

GETList transactions
/transactions
POSTCreate a transaction
/transactions
POSTArchive a transaction
/transactions/archive
POSTExport a transaction report
/transactions/export
GETGet an export's status
/transactions/exports/{export_id}
GETList a filing's transactions
/transactions/filings/{filing_id}
GETGet connections' transaction date ranges
/transactions/min-max-date
GETList transaction sources
/transactions/sources
GETSummarize transactions
/transactions/summary
GETGet a transaction by id
/transactions/{transaction_id}
PUTUpdate a transaction
/transactions/{transaction_id}
PATCHUpdate a credit note
/transactions/{transaction_id}
PATCHUpdate a transaction's addresses
/transactions/{transaction_id}/addresses
GETGet a transaction's backlink
/transactions/{transaction_id}/backlink
GETList related transactions
/transactions/{transaction_id}/related
PATCHMark or unmark a transaction as tax-only
/transactions/{transaction_id}/tax-only

Users

GETList organization users
/users
GETList pending organization invitations
/users/invites
POSTInvite a user to an organization
/users/invites
DELETERevoke a pending organization invitation
/users/invites/{invite_id}
PATCHUpdate an organization user's role
/users/{user_id}
DELETERemove a user from an organization
/users/{user_id}
Kintsugi Tenanted API Reference (2026-07-21)