Get Document

Returns a short-lived presigned URL for downloading a specific document from an application.

GET /api/external/applications/{id}/documents/{docId}

Authentication

Requires an API key with applications:read scope. The application must belong to the organization associated with the API key.

Authorization: Bearer klara_{client_id}.{secret}

Path parameters

string

required

UUID of the application.

string

required

UUID of the document.

Response

Returns 200 OK with a presigned download URL.

string

Presigned S3 URL valid for 1 hour. Use this to download the file directly.

string

Original file name.

string

MIME type of the file (e.g., application/pdf, image/jpeg).

Examples

# Get the download URL
curl "https://app.klara-ai.com/api/external/applications/550e8400.../documents/770e8400..." \
  -H "Authorization: Bearer klara_abc123def456.your-secret-here"

# Then download the file
curl -o document.pdf "https://s3.amazonaws.com/..."

const response = await fetch(
  'https://app.klara-ai.com/api/external/applications/550e8400.../documents/770e8400...',
  {
    headers: {
      'Authorization': 'Bearer klara_abc123def456.your-secret-here'
    }
  }
);

const { url, file_name, file_type } = await response.json();

// Download the file using the presigned URL
const fileResponse = await fetch(url);
const fileBuffer = await fileResponse.arrayBuffer();

import requests

response = requests.get(
    'https://app.klara-ai.com/api/external/applications/550e8400.../documents/770e8400...',
    headers={'Authorization': 'Bearer klara_abc123def456.your-secret-here'}
)

data = response.json()

# Download the file using the presigned URL
file_response = requests.get(data['url'])
with open(data['file_name'], 'wb') as f:
    f.write(file_response.content)

Response:

{
  "url": "https://s3.amazonaws.com/bucket/org-id/applications/app-id/1706123456-passport-scan.pdf?X-Amz-...",
  "file_name": "passport-scan.pdf",
  "file_type": "application/pdf"
}

Download URLs expire after 1 hour. If the URL has expired, request a new one by calling this endpoint again.

Errors

Status	Error	Cause
`401`	`Invalid API key`	API key is invalid, expired, or inactive
`401`	`API key missing required scopes: applications:read`	Key lacks the required scope
`404`	`Application not found`	Application does not exist or belongs to a different organization
`404`	`Document not found`	Document does not exist or does not belong to this application
`500`	`Internal server error`	An unexpected error occurred

Overview

Applications

Reference

Authentication

Path parameters

Response

Examples

Errors

​Authentication

​Path parameters

​Response

​Examples

​Errors

Authentication

Path parameters

Response

Examples

Errors