KintsugiKintsugi

List attachments for a related entity

GET/attachments

List the attachments held against one related entity, most recent first. Covers every organization your credential owns; send an Organization-Id, Connection-Id or Entity-Id selector to narrow to one. relatedEntityId and relatedEntityType are both required. Returns an empty list when the entity has no attachments, or is not one your credential can 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.

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.

/attachments?relatedEntityId=<relatedEntityId>&relatedEntityType=<relatedEntityType>
relatedEntityIdstringRequired

The related entity whose attachments to list.

relatedEntityTypestringRequired

Kind of related entity.

Response

idstringRequired

Kintsugi's unique identifier for the attachment.

fileNamestringRequired

Name the file was uploaded under.

contentTypestringRequired

Media type of the file.

sizeintegerRequired

Size of the file in bytes.

relatedEntityRelatedEntityRefRequired

The entity this attachment is held against.

uploadedAtstringRequired

When the attachment was uploaded, as an RFC-3339 UTC timestamp.

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 /attachments?relatedEntityId={relatedEntityId}&relatedEntityType={relatedEntityType}
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Example request
https://api.trykintsugi.com/attachments?relatedEntityId={relatedEntityId}&relatedEntityType={relatedEntityType}
Response
[
{
"id": "atch_2mNpQr7Ls8f3k",
"fileName": "resale-certificate.pdf",
"contentType": "application/pdf",
"size": 20481,
"relatedEntity": {
"id": "exmp_2mNpQr7Ls8f3k",
"type": "EXEMPTION"
},
"uploadedAt": "2026-07-28T12:00:00Z"
}
]
List attachments for a related entity (2026-07-21) | Kintsugi API Reference