Skip to main content
Get Evaluation Results
curl --request GET \
  --url https://api.getpique.ai/v1/evaluations/results/{job_id} \
  --header 'X-API-Key: <api-key>'
{
  "event": "<string>",
  "job_id": "<string>",
  "content_id": "<string>",
  "judge_id": "<string>",
  "status": "<string>",
  "overall_score": 123,
  "detector_results": [
    {}
  ],
  "error": "<string>",
  "timestamp": "<string>"
}

​
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

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

​
Request Example

curl "https://api.getpique.ai/v1/evaluations/results/job_xKt9mNp2qRs3vWy7" \
  -H "X-API-Key: pq_your_api_key_here"

​
Response

​
event
string
Event type indicating the evaluation state.Possible values: evaluation.completed, evaluation.failed, evaluation.pending
​
job_id
string
The evaluation job ID
​
content_id
string
The content record ID (available once processing begins)
​
judge_id
string
The judge that evaluated the content
​
status
string
Current job status.Possible values: awaiting_upload, pending, processing, completed, failed
​
overall_score
number
Overall evaluation score. Only present for completed evaluations.
​
detector_results
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
​
error
string
Error message. Only present for failed evaluations.
​
timestamp
string
ISO 8601 timestamp of when the evaluation completed (or was created, if still pending)

​
Response Examples

​
Completed Evaluation

{
  "event": "evaluation.completed",
  "job_id": "job_xKt9mNp2qRs3vWy7",
  "content_id": "550e8400-e29b-41d4-a716-446655440000",
  "judge_id": "a1b2c3d4-e5f6-4789-9012-3456789abcde",
  "status": "completed",
  "overall_score": 0.85,
  "detector_results": [
    {
      "detector_name": "video_specs",
      "detector_config_id": "848b9b59-2775-4303-8912-0a6ff40b6fd6",
      "pass_check": true,
      "score": 1.0,
      "rationale": "Video specs meet requirements: 576x1024 (9:16), 30.0fps, 38.0s",
      "metrics": {
        "video_specs": {
          "width": 576,
          "height": 1024,
          "aspect_ratio": "9:16",
          "fps": 30,
          "duration_sec": 38.03
        }
      },
      "timestamps": [],
      "flagged_frames": []
    }
  ],
  "error": null,
  "timestamp": "2025-11-12T23:16:08Z"
}

​
Failed Evaluation

{
  "event": "evaluation.failed",
  "job_id": "job_3vp2mT7dJh5vhZmpk2G_yg",
  "content_id": null,
  "judge_id": "9e8ed8b4-e4ff-4137-9469-11181586a9e6",
  "status": "failed",
  "overall_score": null,
  "detector_results": null,
  "error": "Media processing failed",
  "timestamp": "2025-11-12T23:16:08Z"
}

​
Pending Evaluation

{
  "event": "evaluation.pending",
  "job_id": "job_xKt9mNp2qRs3vWy7",
  "content_id": null,
  "judge_id": "a1b2c3d4-e5f6-4789-9012-3456789abcde",
  "status": "processing",
  "overall_score": null,
  "detector_results": null,
  "error": null,
  "timestamp": "2025-11-12T23:15:00Z"
}

​
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