KintsugiKintsugi

Approve multiple certificate imports

POST/certificate-imports/bulk-approve

Approve several certificate imports in the resolved organization in one request, each with its own approval values. This is non-atomic: each import is approved independently, so a failure on one does not roll back the others. The response carries a per-import outcome, with an error on any that failed. Returns 404 if the resolved organization is not one your credential can access. A free plan is refused with 403 PLAN_UPGRADE_REQUIRED. A paid plan without exemption certificate management is refused with 403 FORBIDDEN.

Authorization

Api-KeystringRequired

Your secret API key. Include it with every request.

Headers

Api-Versiondate

Release date, as YYYY-MM-DD. Defaults to 2026-07-21.

Organization-Idstring

Target organization id (Organization-Id selector).

Connection-Idstring

Target connection id; resolves to its organization.

Entity-Idstring

Platform entity id; resolves to a connection's organization.

Entity-Sourcestring

Optional source to disambiguate an Entity-Id.

Body

itemsCertificateImportBulkApproveItem[]Required

The certificate imports to approve, each with its approval values.

Response

totalintegerRequired

Number of imports in the request.

approvedintegerRequired

Number of imports that were approved.

failedintegerRequired

Number of imports that failed to approve.

resultsCertificateImportBulkApproveResultItem[]Required

Per-import outcome, in request order.

200

Successful Response

400

The request was invalid.

401

Authentication failed or was missing.

403

The credential is not permitted for this request.

404

The requested resource was not found.

422

The request failed validation.

cURL
POST /certificate-imports/bulk-approve
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
{
"items": [
{
"customerId": "cust_2mNpQr7Ls8f3k",
"jurisdictions": [
"AZ",
"CA"
],
"exemptionType": "customer",
"startDate": "2026-01-01",
"endDate": "2026-12-31",
"fein": "20-7654321",
"salesTaxId": "ST-12345",
"buyerBusinessName": "Acme LLC",
"sellerBusinessName": "Kintsugi Inc",
"certificateImportId": "ecim_2mNpQr7Ls8f3k"
}
]
}
Response
{
"total": 3,
"approved": 2,
"failed": 1,
"results": [
{
"certificateImportId": "ecim_2mNpQr7Ls8f3k",
"status": "approved",
"exemptionIds": [
"exmp_2mNpQr7Ls8f3k"
],
"error": "Cannot approve this certificate. It is not in a reviewable state."
}
]
}
Approve multiple certificate imports (2026-07-21) | Kintsugi API Reference