KintsugiKintsugi

List certificate imports by upload session

GET/certificate-imports/sessions/{upload_session_id}

List every certificate import in one upload session, so a client can watch OCR review progress. Searched across every organization your credential owns, so no selector is needed for a known session. Returns 404 if the session does not exist or belongs to an organization your credential cannot access.

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

Narrow the request to one organization (Organization-Id selector).

Connection-Idstring

Narrow the request to a connection's organization.

Entity-Idstring

Narrow the request to a platform entity's organization.

Entity-Sourcestring

Optional source to disambiguate an Entity-Id.

Path parameters

upload_session_idstringRequired

The upload session to list imports for.

Response

idstringRequired

Kintsugi's unique identifier for the certificate import.

uploadSessionIdstringRequired

Identifier of the upload batch this import belongs to.

fileNamestringRequired

Name the file was uploaded under.

mimeTypestringRequired

Media type of the uploaded file.

reviewStatusPublicCertificateImportReviewStatusEnumRequired

Where this import sits in the OCR review flow.

Available options:QUEUEDPROCESSINGUNSUPPORTEDSUGGESTED_REJECTDUPLICATENEEDS_REVIEWREADY_TO_APPROVEAPPROVEDREJECTED
customerIdstringRequired

Customer that OCR matched this certificate to, or null when no customer has been matched.

customerMatchStatusPublicCustomerMatchStatusEnumRequired

Outcome of the OCR customer match, or null before matching has run.

Available options:MATCHEDSUGGESTEDUNMATCHED
createdAtstringRequired

When the import was created, as an RFC-3339 UTC timestamp.

updatedAtstringRequired

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.

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.

409

The request conflicts with existing state.

422

The request failed validation.

cURL
GET /certificate-imports/sessions/{upload_session_id}
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Example request
https://api.trykintsugi.com/certificate-imports/sessions/{upload_session_id}
Response
[
{
"id": "ecim_2mNpQr7Ls8f3k",
"uploadSessionId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"fileName": "resale-certificate.pdf",
"mimeType": "application/pdf",
"reviewStatus": "QUEUED",
"customerId": "cust_2mNpQr7Ls8f3k",
"customerMatchStatus": "MATCHED",
"createdAt": "2026-07-28T12:00:00Z",
"updatedAt": "2026-07-28T12:05:00Z"
}
]
List certificate imports by upload session (2026-07-21) | Kintsugi API Reference