GET
/
v1
/
analyses
/
{analysisId}
Get Analysis
curl --request GET \
  --url https://api.example.com/v1/analyses/{analysisId}
{
  "403": {},
  "404": {},
  "analysisId": "<string>",
  "status": "<string>",
  "createdAt": "<string>",
  "completedAt": "<string>",
  "fileInfo": {
    "fileId": "<string>",
    "fileName": "<string>",
    "duration": 123,
    "size": 123
  },
  "fraudAnalysis": {
    "riskScore": 123,
    "riskLevel": "<string>",
    "fraudIndicators": [
      {
        "type": "<string>",
        "confidence": 123,
        "severity": "<string>",
        "timestamp": "<string>",
        "description": "<string>"
      }
    ],
    "summary": "<string>"
  },
  "transcription": {
    "text": "<string>",
    "speakers": [
      {}
    ],
    "language": "<string>",
    "confidence": 123
  }
}

​
Get Analysis

Retrieve the complete results of a fraud analysis, including transcription, risk assessment, and fraud indicators.

​
Request

​
analysisId
string
required
The unique identifier of the analysis
​
include
array
Additional data to include in response
  • transcription: Full transcription with timestamps
  • audio: Audio file metadata
  • reviews: Associated review data
  • history: Analysis history and updates

​
Response

​
analysisId
string
Unique identifier for the analysis
​
status
string
Analysis status: queued, processing, completed, failed
​
createdAt
string
ISO 8601 timestamp of creation
​
completedAt
string
ISO 8601 timestamp of completion
​
fileInfo
object
Audio file information
​
fraudAnalysis
object
Fraud detection results
​
transcription
object
Transcription data (if requested)

​
Examples

curl -X GET https://api.authentivoice.com/v1/analyses/ana_1234567890abcdef \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Response Example

{
  "analysisId": "ana_1234567890abcdef",
  "status": "completed",
  "createdAt": "2024-01-15T10:30:00Z",
  "completedAt": "2024-01-15T10:32:45Z",
  "fileInfo": {
    "fileId": "file_0987654321fedcba",
    "fileName": "call_recording_20240115.mp3",
    "duration": 245.5,
    "size": 3686400
  },
  "fraudAnalysis": {
    "riskScore": 78,
    "riskLevel": "high",
    "fraudIndicators": [
      {
        "type": "urgency_language",
        "confidence": 0.85,
        "severity": "high",
        "timestamp": "00:45-01:20",
        "description": "Caller used urgent language to pressure immediate action"
      },
      {
        "type": "personal_info_request",
        "confidence": 0.92,
        "severity": "high",
        "timestamp": "02:15-02:45",
        "description": "Request for sensitive personal information including SSN"
      },
      {
        "type": "authority_claim",
        "confidence": 0.78,
        "severity": "medium",
        "timestamp": "00:10-00:25",
        "description": "Caller claimed to be from government agency"
      }
    ],
    "summary": "High-risk call detected. The caller exhibited multiple fraud indicators including urgent language, requests for personal information, and false authority claims. Immediate review recommended."
  },
  "transcription": {
    "text": "Hello, this is Agent Smith from the IRS...",
    "speakers": [
      {
        "speaker": 1,
        "start": 0.0,
        "end": 25.3,
        "text": "Hello, this is Agent Smith from the IRS..."
      },
      {
        "speaker": 2,
        "start": 25.3,
        "end": 28.7,
        "text": "Oh, hello. What is this regarding?"
      }
    ],
    "language": "en",
    "confidence": 0.95
  }
}

​
Error Responses

​
404
Not Found
Analysis not found
{
  "error": {
    "code": "ANALYSIS_NOT_FOUND",
    "message": "The specified analysis was not found"
  }
}
​
403
Forbidden
Access denied
{
  "error": {
    "code": "ACCESS_DENIED",
    "message": "You do not have permission to view this analysis"
  }
}