curl --request POST \
--url https://api.next.orenda.finance/v1/customers/{customerId}/documents/presign \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"collection": "kyc",
"documentType": "PROOF_OF_ADDRESS",
"contentType": "application/pdf"
}
'{
"success": true,
"data": {
"uploadUrl": "https://orenda-kyc-documents.s3.eu-west-1.amazonaws.com/cust_3f9a2b7e/kyc/proof-of-address.pdf?X-Amz-Signature=...",
"bucket": "orenda-kyc-documents",
"key": "cust_3f9a2b7e/kyc/proof-of-address.pdf",
"method": "PUT",
"contentType": "application/pdf",
"expiresInSeconds": 900
}
}Get a document presign URL
Returns a short-lived presigned URL for a verification document — either to upload a file directly to storage (instead of sending it inline base64), or to download a document already on the application. The mode is decided by the body:
- Upload: send
collection+documentType(nokey/s3Url). You get anuploadUrl;PUTthe file to it with the sameContent-Type. - Download: send
applicationIdplus eithers3Url, orcollection+key. You get adownloadUrltoGET.
curl --request POST \
--url https://api.next.orenda.finance/v1/customers/{customerId}/documents/presign \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"collection": "kyc",
"documentType": "PROOF_OF_ADDRESS",
"contentType": "application/pdf"
}
'{
"success": true,
"data": {
"uploadUrl": "https://orenda-kyc-documents.s3.eu-west-1.amazonaws.com/cust_3f9a2b7e/kyc/proof-of-address.pdf?X-Amz-Signature=...",
"bucket": "orenda-kyc-documents",
"key": "cust_3f9a2b7e/kyc/proof-of-address.pdf",
"method": "PUT",
"contentType": "application/pdf",
"expiresInSeconds": 900
}
}Authorizations
The user's id_token from authentication — the ID token, not the access_token. The program and environment (sandbox/prod) are read from the token.
Path Parameters
The customer's ID.
Body
Upload: required. Download by key: required. Which document collection.
kyc, kyb Upload: required. A document type from the program's KYC schema.
Upload: optional. MIME type the file will be PUT with, e.g. application/pdf.
Download: required. The application the document belongs to.
Download: the document's storage URI (e.g. from the upload response). Use this or collection + key.
Download: the document's storage key. Send with collection.
Optional. How long the URL stays valid (clamped to a server-side maximum).