GET
/
v1
/
reviews
/
{reviewId}
Get Review
curl --request GET \
  --url https://api.example.com/v1/reviews/{reviewId}
{
  "403": {},
  "404": {},
  "reviewId": "<string>",
  "analysisId": "<string>",
  "status": "<string>",
  "priority": "<string>",
  "reviewType": "<string>",
  "assignedTo": {
    "userId": "<string>",
    "email": "<string>",
    "name": "<string>",
    "role": "<string>"
  },
  "createdAt": "<string>",
  "startedAt": "<string>",
  "completedAt": "<string>",
  "deadline": "<string>",
  "findings": {
    "fraudConfirmed": true,
    "riskAssessment": "<string>",
    "notes": "<string>",
    "flaggedSections": [
      {}
    ],
    "recommendedActions": [
      {}
    ]
  },
  "analysis": {}
}

​
Get Review

Retrieve complete details about a review, including associated analysis data and reviewer feedback.

​
Request

​
reviewId
string
required
The unique identifier of the review
​
include
array
Additional data to include
  • analysis: Full analysis data
  • transcription: Call transcription
  • history: Review history and updates
  • reviewer: Detailed reviewer information

​
Response

​
reviewId
string
Unique review identifier
​
analysisId
string
Associated analysis ID
​
status
string
Review status: pending, in_progress, completed, escalated
​
priority
string
Review priority: low, normal, high, urgent
​
reviewType
string
Type of review: standard, detailed, compliance, quality
​
assignedTo
object
Assigned reviewer
​
createdAt
string
Review creation timestamp
​
startedAt
string
When review was started
​
completedAt
string
When review was completed
​
deadline
string
Review deadline if set
​
findings
object
Review findings (if completed)
​
analysis
object
Full analysis data (if requested)

​
Examples

curl -X GET "https://api.authentivoice.com/v1/reviews/rev_abc123def456?include=analysis,history" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Response Example

{
  "reviewId": "rev_abc123def456",
  "analysisId": "ana_1234567890abcdef",
  "status": "completed",
  "priority": "high",
  "reviewType": "detailed",
  "assignedTo": {
    "userId": "user_789012",
    "email": "jane.reviewer@company.com",
    "name": "Jane Reviewer",
    "role": "Senior Reviewer"
  },
  "createdAt": "2024-01-15T12:00:00Z",
  "startedAt": "2024-01-15T12:15:00Z",
  "completedAt": "2024-01-15T12:45:00Z",
  "deadline": "2024-01-16T17:00:00Z",
  "findings": {
    "fraudConfirmed": true,
    "riskAssessment": "high",
    "notes": "Confirmed multiple fraud indicators. Caller used social engineering tactics to obtain personal information. Clear urgency pressure and false authority claims.",
    "flaggedSections": [
      {
        "timestamp": "00:45-01:20",
        "reason": "Urgency tactics"
      },
      {
        "timestamp": "02:15-02:45",
        "reason": "Personal info request"
      }
    ],
    "recommendedActions": [
      "Report to fraud prevention team",
      "Block caller number",
      "Contact affected customer",
      "File regulatory report"
    ]
  },
  "analysis": {
    "riskScore": 85,
    "riskLevel": "high",
    "fraudIndicators": [
      {
        "type": "urgency_language",
        "confidence": 0.92
      },
      {
        "type": "authority_claim",
        "confidence": 0.88
      }
    ]
  }
}

​
Review History

When including history, you’ll see all status changes: 
{
  "history": [
    {
      "timestamp": "2024-01-15T12:00:00Z",
      "event": "created",
      "user": "system"
    },
    {
      "timestamp": "2024-01-15T12:05:00Z",
      "event": "assigned",
      "user": "system",
      "details": {
        "assignedTo": "user_789012"
      }
    },
    {
      "timestamp": "2024-01-15T12:15:00Z",
      "event": "started",
      "user": "user_789012"
    },
    {
      "timestamp": "2024-01-15T12:45:00Z",
      "event": "completed",
      "user": "user_789012"
    }
  ]
}

​
Error Responses

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