Skip to main content

Get a stipulation document download URL

Returns an S3 download URL valid for six hours. Fetch the returned url directly to receive the file as an attachment.

stipulationId is the id of an entry returned by the stipulation list endpoint, verbatim (for example <creditorId>_<applicantId>_CONTRACT_<templateId>). documentId selects which of that stipulation's files to download:

  • generated — the document CreditApp generated from the template. Available when the list entry reports generatedDocumentAvailable: true.
  • an id from the list entry's documents array — an uploaded document. Available when that document reports downloadAvailable: true.

Document IDs are scoped to the specified stipulation, application and creditor. Only documents visible to the caller can be downloaded; anything else returns 404.

Path Parameters
applicationId string — REQUIRED
creditorId string — REQUIRED
stipulationId string — REQUIRED
documentId string — REQUIRED
Header Parameters
X-CreditApp-Creditor-ID uuid
Responses
200

Download URL

Schema — OPTIONAL
url uri
403

Access denied

404

Application, creditor application, stipulation or visible document not found