> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getpique.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Evaluation Results

> Get evaluation results by job ID

## 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](/api-docs/api-reference/evaluations/presigned-upload) or [Social Media](/api-docs/api-reference/evaluations/social-media) endpoints.

## Path Parameters

<ParamField path="job_id" type="string" required>
  The evaluation job ID (e.g. `job_xKt9mNp2qRs3vWy7`)
</ParamField>

## Request Example

```bash theme={null}
curl "https://api.getpique.ai/v1/evaluations/results/job_xKt9mNp2qRs3vWy7" \
  -H "X-API-Key: pq_your_api_key_here"
```

## Response

<ResponseField name="event" type="string">
  Event type indicating the evaluation state.

  **Possible values:** `evaluation.completed`, `evaluation.failed`, `evaluation.pending`
</ResponseField>

<ResponseField name="job_id" type="string">
  The evaluation job ID
</ResponseField>

<ResponseField name="content_id" type="string">
  The content record ID (available once processing begins)
</ResponseField>

<ResponseField name="judge_id" type="string">
  The judge that evaluated the content
</ResponseField>

<ResponseField name="status" type="string">
  Current job status.

  **Possible values:** `awaiting_upload`, `pending`, `processing`, `completed`, `failed`
</ResponseField>

<ResponseField name="overall_score" type="number">
  Overall evaluation score. Only present for completed evaluations.
</ResponseField>

<ResponseField name="detector_results" type="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
</ResponseField>

<ResponseField name="error" type="string">
  Error message. Only present for failed evaluations.
</ResponseField>

<ResponseField name="timestamp" type="string">
  ISO 8601 timestamp of when the evaluation completed (or was created, if still pending)
</ResponseField>

## Response Examples

### Completed Evaluation

```json theme={null}
{
  "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

```json theme={null}
{
  "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

```json theme={null}
{
  "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