GET
/
v1
/
analyses
{
  "400": {},
  "429": {},
  "data": [
    {
      "analysisId": "<string>",
      "status": "<string>",
      "riskScore": 123,
      "riskLevel": "<string>",
      "duration": 123,
      "createdAt": "<string>",
      "tags": [
        {}
      ],
      "summary": "<string>"
    }
  ],
  "pagination": {
    "page": 123,
    "limit": 123,
    "total": 123,
    "pages": 123,
    "hasNext": true,
    "hasPrev": true
  }
}

​
List Analyses

Retrieve a paginated list of call analyses with powerful filtering and sorting options.

​
Request

​
page
integer
default:1
Page number for pagination
​
limit
integer
default:20
Number of results per page (max: 100)
​
status
string
Filter by status: queued, processing, completed, failed
​
riskLevel
string
Filter by risk level: very_low, low, medium, high, critical
​
minRiskScore
integer
Minimum risk score (0-100)
​
maxRiskScore
integer
Maximum risk score (0-100)
​
dateFrom
string
Filter analyses created after this date (ISO 8601)
​
dateTo
string
Filter analyses created before this date (ISO 8601)
​
tags
array
Filter by tags (comma-separated)
​
search
string
Search in transcriptions and notes
​
sortBy
string
default:"createdAt"
Sort field: createdAt, riskScore, duration
​
sortOrder
string
default:"desc"
Sort order: asc, desc

​
Response

​
data
array
Array of analysis objects
​
pagination
object
Pagination information

​
Examples

# Get high-risk analyses from the last week
curl -X GET "https://api.authentivoice.com/v1/analyses?riskLevel=high&dateFrom=2024-01-08T00:00:00Z&sortBy=riskScore&sortOrder=desc" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Response Example

{
  "data": [
    {
      "analysisId": "ana_1234567890abcdef",
      "status": "completed",
      "riskScore": 85,
      "riskLevel": "high",
      "duration": 245.5,
      "createdAt": "2024-01-15T10:30:00Z",
      "tags": ["sales", "inbound"],
      "summary": "High-risk call with multiple fraud indicators detected"
    },
    {
      "analysisId": "ana_fedcba0987654321",
      "status": "completed",
      "riskScore": 72,
      "riskLevel": "high",
      "duration": 180.3,
      "createdAt": "2024-01-15T09:15:00Z",
      "tags": ["support", "escalation"],
      "summary": "Suspicious caller behavior with information requests"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 156,
    "pages": 8,
    "hasNext": true,
    "hasPrev": false
  }
}

​
Advanced Filtering

​
Complex Queries

Combine multiple filters for precise results: 
# High-risk financial calls from specific date range
curl -X GET "https://api.authentivoice.com/v1/analyses?\
minRiskScore=70&\
tags=financial&\
dateFrom=2024-01-01T00:00:00Z&\
dateTo=2024-01-15T23:59:59Z&\
status=completed&\
sortBy=riskScore&\
sortOrder=desc" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Search Functionality

The search parameter searches across:
  • Transcription text
  • Analysis notes
  • Caller information
  • Tags
# Search for specific keywords
curl -X GET "https://api.authentivoice.com/v1/analyses?search=social+security+number" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Error Responses

​
400
Bad Request
Invalid query parameters
{
  "error": {
    "code": "INVALID_PARAMETERS",
    "message": "Invalid date format. Use ISO 8601 format."
  }
}
​
429
Too Many Requests
Rate limit exceeded
{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests. Please try again later.",
    "retryAfter": 60
  }
}