KintsugiKintsugi

List certificate imports by review status

GET/certificate-imports

List certificate imports filtered by review status, so a client can build a review queue. Repeat the status query parameter for multiple values (e.g. ?status=NEEDS_REVIEW&status=READY_TO_APPROVE). Covers every organization your credential owns; send an Organization-Id, Connection-Id or Entity-Id selector to narrow to one. Returns an empty list when nothing matches.

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.

Query

Every query parameter below is optional. Combine as many as you need and append them to the endpoint as a query string. The example shows a few to get you started.

/certificate-imports?status=<status>
statusstring[]Required

Review status filter. Repeat for multiple values.

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?status={status}
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Example request
https://api.trykintsugi.com/certificate-imports?status={status}
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 review status (2026-07-21) | Kintsugi API Reference