KintsugiKintsugi

Download an exemption certificate

GET/exemptions/{exemption_id}/certificates/{certificate_id}

Return a certificate's metadata and a short-lived URL to download its bytes. Searched across every organization your credential owns, so no selector is needed for a known id. Fetch downloadUrl directly with a GET; it expires after expiresInSeconds. Returns 404 if the exemption or the certificate does not exist, is archived, or belongs to an organization your credential cannot access, or if the certificate is not attached to this exemption.

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

exemption_idstringRequired

The unique identifier of the exemption.

certificate_idstringRequired

The unique identifier of the certificate document.

Response

idstringRequired

Kintsugi's unique identifier for the certificate document.

fileNamestringRequired

Name the file was uploaded under.

mimeTypestringRequired

Media type of the file.

fileSizeBytesintegerRequired

Size of the file in bytes.

downloadUrlstringRequired

Time-limited URL to download the certificate bytes. Fetch it directly with a GET; do not send your API credentials to it. It stops working after expiresInSeconds, so request this endpoint again for a fresh URL rather than storing it.

expiresInSecondsintegerRequired

Seconds from now until downloadUrl stops working.

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 /exemptions/{exemption_id}/certificates/{certificate_id}
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Example request
https://api.trykintsugi.com/exemptions/{exemption_id}/certificates/{certificate_id}
Response
{
"id": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"fileName": "resale-certificate.pdf",
"mimeType": "application/pdf",
"fileSizeBytes": 20481,
"downloadUrl": "https://s3.amazonaws.com/kintsugi-attachments/orgn_1/atch_1?...",
"expiresInSeconds": 300
}
Download an exemption certificate (2026-07-21) | Kintsugi API Reference