KintsugiKintsugi

Upload a certificate for a customer

POST/exemptions/missing-certificates/{customer_id}/upload

Upload a certificate on a customer's behalf, as multipart/form-data with the file in the file part, to cover their uncertified jurisdictions. The file must be a PDF, PNG or JPG and at most 10 MB. Creates one validation job per uncovered exemption and returns 202 with an uploadSessionId; poll GET /exemptions/missing-certificates/{customerId}/upload-status/{uploadSessionId} for per-jurisdiction results. Scoped to one organization the same way as the list. Returns 404 if the customer has no uncovered exemptions in an organization 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.

Path parameters

customer_idstringRequired

The customer whose uncovered exemptions this upload targets.

Response

uploadSessionIdstringRequired

Poll GET /exemptions/missing-certificates/{customerId}/upload-status/{uploadSessionId} with this for per-jurisdiction results.

certificateImportIdsstring[]Required

One import id per uncovered exemption the upload targets.

statusPublicMissingCertificateStatusEnum

Always PROCESSING at acceptance; poll the status endpoint for results.

Available options:processingsatisfiedrejected
202

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.

413

The request body is larger than this endpoint accepts.

422

The request failed validation.

cURL
POST /exemptions/missing-certificates/{customer_id}/upload
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Example request
https://api.trykintsugi.com/exemptions/missing-certificates/{customer_id}/upload
Response
{
"uploadSessionId": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"certificateImportIds": [
"3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10"
],
"status": "processing"
}
Upload a certificate for a customer (2026-07-21) | Kintsugi API Reference