Skip to main content
Get Evaluation Results

Authentication

Required: API Key authentication via X-API-Key header

Overview

Retrieve evaluation results for a specific job. The response uses the same format as webhook notifications. Use the job_id returned from the Direct Upload or Social Media endpoints.

Path Parameters

string
required
The evaluation job ID (e.g. job_xKt9mNp2qRs3vWy7)

Request Example

Response

string
Event type indicating the evaluation state.Possible values: evaluation.completed, evaluation.failed, evaluation.pending
string
The evaluation job ID
string
The content record ID (available once processing begins)
string
The judge that evaluated the content
string
Current job status.Possible values: awaiting_upload, pending, processing, completed, failed
number
Overall evaluation score. Only present for completed evaluations.
array
Array of individual detector results. Only present for completed evaluations.Each detector result contains:
  • detector_name — Name of the detector
  • detector_config_id — Detector configuration ID
  • pass_check — Whether the content passed the check
  • score — Detector score
  • rationale — Explanation of the result
  • metrics — Detector-specific metrics
  • timestamps — Flagged timestamps (seconds)
  • flagged_frames — Flagged frame metadata
string
Error message. Only present for failed evaluations.
string
ISO 8601 timestamp of when the evaluation completed (or was created, if still pending)

Response Examples

Completed Evaluation

Failed Evaluation

Pending Evaluation

Error Responses

401 Unauthorized

Missing or invalid API key

404 Not Found

Job not found or not accessible by your organization

500 Internal Server Error

Server error while fetching results