POST
/
v1
/
analyses
/
{analysisId}
/
export
/
pdf
Export PDF Report
curl --request POST \
  --url https://api.example.com/v1/analyses/{analysisId}/export/pdf \
  --header 'Content-Type: application/json' \
  --data '
{
  "template": "<string>",
  "sections": [
    {}
  ],
  "options": {
    "includeAudioLink": true,
    "highlightRisks": true,
    "includeCharts": true,
    "watermark": "<string>",
    "password": "<string>",
    "expiryDays": 123
  },
  "branding": {
    "logoUrl": "<string>",
    "primaryColor": "<string>",
    "companyName": "<string>",
    "footer": "<string>"
  }
}
'
{
  "404": {},
  "422": {},
  "503": {},
  "exportId": "<string>",
  "status": "<string>",
  "downloadUrl": "<string>",
  "expiresAt": "<string>",
  "fileSize": 123,
  "pageCount": 123
}

​
Export PDF Report

Generate a professional PDF report containing complete analysis details, transcription, and review findings.

​
Request

​
analysisId
string
required
The unique identifier of the analysis to export
​
template
string
default:"standard"
Report template to use: standard, detailed, executive, compliance
​
sections
array
Sections to include in the report (defaults to all)
  • summary - Executive summary
  • metadata - Call metadata and file info
  • transcription - Full transcription with timestamps
  • fraud_analysis - Detailed fraud indicators
  • risk_assessment - Risk scoring and levels
  • review_findings - Reviewer notes and decisions
  • recommendations - Suggested actions
  • audit_trail - Processing and review history
​
options
object
PDF generation options
​
branding
object
Custom branding options

​
Response

​
exportId
string
Unique identifier for the export
​
status
string
Export status: processing, completed, failed
​
downloadUrl
string
Secure download URL (when completed)
​
expiresAt
string
Download link expiration time
​
fileSize
integer
PDF file size in bytes
​
pageCount
integer
Number of pages in PDF

​
Examples

# Generate standard report
curl -X POST https://api.authentivoice.com/v1/analyses/ana_1234567890abcdef/export/pdf \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "template": "standard",
    "options": {
      "includeAudioLink": true,
      "highlightRisks": true,
      "watermark": "CONFIDENTIAL"
    }
  }'

​
Response Example

​
Processing

{
  "exportId": "exp_pdf_abc123",
  "status": "processing",
  "estimatedTime": 30,
  "message": "Generating PDF report..."
}

​
Completed

{
  "exportId": "exp_pdf_abc123",
  "status": "completed",
  "downloadUrl": "https://api.authentivoice.com/v1/exports/exp_pdf_abc123/download",
  "expiresAt": "2024-01-22T15:00:00Z",
  "fileSize": 2457600,
  "pageCount": 12,
  "generated": "2024-01-15T15:00:00Z"
}

​
Report Templates

​
Standard Template

  • Executive summary
  • Basic fraud analysis
  • Key findings
  • Recommendations
  • 3-5 pages typical

​
Detailed Template

  • Complete transcription
  • Timestamped fraud indicators
  • Detailed risk analysis
  • Full review notes
  • 10-20 pages typical

​
Executive Template

  • High-level summary
  • Visual risk dashboard
  • Key metrics only
  • Action items
  • 1-2 pages typical

​
Compliance Template

  • Regulatory information
  • Detailed audit trail
  • Compliance checkpoints
  • Evidence documentation
  • 15-30 pages typical

​
Webhook Notification

If webhooks are configured, you’ll receive a notification when export completes: 
{
  "event": "export.completed",
  "data": {
    "exportId": "exp_pdf_abc123",
    "analysisId": "ana_1234567890abcdef",
    "type": "pdf",
    "status": "completed",
    "downloadUrl": "https://api.authentivoice.com/v1/exports/exp_pdf_abc123/download"
  }
}

​
Batch Export

Export multiple analyses in a single PDF: 
POST /v1/export/pdf/batch

{
  "analysisIds": [
    "ana_123",
    "ana_456",
    "ana_789"
  ],
  "template": "standard",
  "combineIntoOne": true
}

​
Error Responses

​
404
Not Found
Analysis not found
{
  "error": {
    "code": "ANALYSIS_NOT_FOUND",
    "message": "The specified analysis was not found"
  }
}
​
422
Unprocessable Entity
Export configuration error
{
  "error": {
    "code": "INVALID_TEMPLATE",
    "message": "Unknown template type. Valid options: standard, detailed, executive, compliance"
  }
}
​
503
Service Unavailable
Export service unavailable
{
  "error": {
    "code": "EXPORT_SERVICE_UNAVAILABLE",
    "message": "PDF generation service is temporarily unavailable",
    "retryAfter": 300
  }
}