Approve a certificate import
Approve a reviewed certificate import in the resolved organization. Creates one exemption per entry in jurisdictions, links each to customerId, attaches the uploaded file, and moves the import to APPROVED. Send the final (possibly reviewer-corrected) certificate values in the body. Returns the updated import. Returns 409 if the import is not in a reviewable state (for example, already approved or rejected), and 404 if it does not exist or belongs to an organization your credential cannot access. A free plan is refused with 403 PLAN_UPGRADE_REQUIRED. A paid plan without exemption certificate management is refused with 403 FORBIDDEN.
Authorization
Headers
Release date, as YYYY-MM-DD. Defaults to 2026-07-21.
Target organization id (Organization-Id selector).
Target connection id; resolves to its organization.
Platform entity id; resolves to a connection's organization.
Optional source to disambiguate an Entity-Id.
Path parameters
The unique identifier of the certificate import to approve.
Body
Customer to link the created exemption(s) to.
Two-letter jurisdiction codes to create an exemption for; one exemption is created per entry.
Exemption type to create: customer, wholesale, or transaction.
Exemption start date as YYYY-MM-DD.
Exemption end date as YYYY-MM-DD, or null when the exemption does not expire.
Federal Employer Identification Number, or null if not provided.
State sales tax ID or permit number, or null if not provided.
Corrected buyer business name to persist, or null to leave it unchanged.
Corrected seller business name to persist, or null to leave it unchanged.
Response
Kintsugi's unique identifier for the certificate import.
Identifier of the upload batch this import belongs to.
Name the file was uploaded under.
Media type of the uploaded file.
Where this import sits in the OCR review flow.
QUEUEDPROCESSINGUNSUPPORTEDSUGGESTED_REJECTDUPLICATENEEDS_REVIEWREADY_TO_APPROVEAPPROVEDREJECTEDCustomer that OCR matched this certificate to, or null when no customer has been matched.
Outcome of the OCR customer match, or null before matching has run.
MATCHEDSUGGESTEDUNMATCHEDWhen the import was created, as an RFC-3339 UTC timestamp.
When the import was last updated, as an RFC-3339 UTC timestamp; equal to createdAt for an import that has not been modified since creation.
Successful Response
The request was invalid.
Authentication failed or was missing.
The credential is not permitted for this request.
The requested resource was not found.
The request conflicts with existing state.
The request failed validation.
An unexpected error prevented the request from completing.