---
title: "Poll eval run"
method: GET
path: "/partner/app/{appId}/bizai/agent-eval/run"
tags: ["Operate — Events", "Test & Eval"]
---

# Poll eval run

`GET /partner/app/{appId}/bizai/agent-eval/run`

## Request

- Base URL: `https://partner.gupshup.io`
- URL: `https://partner.gupshup.io/partner/app/{appId}/bizai/agent-eval/run`
- Auth: API key in header `Authorization`

## Query parameters

- `job_id` string, required

## Response `200`

Job status, progress, and the result once `COMPLETED`. **Per Meta reference**.

- EvalJob
  - `status` 'QUEUED' | 'RUNNING' | 'COMPLETED' | 'FAILED', required
  - `progress` object
    - `completed` integer
    - `total` integer
    - `current_stage` 'simulation' | 'evaluation' | 'insights' | 'done'
  - `result` EvalSummary: **Per Meta reference**. The JSON-string fields must be parsed a second time.
    - `id` string
    - `summary_id` string
    - `avg_conversation_score` number
    - `avg_turn_score` number
    - `summary` string
    - `highlights` string: JSON string
    - `top_failure_categories` string: JSON string
    - `eval_ids_by_score` string: JSON string
    - `creation_time` integer
    - `update_time` integer
  - `error` object: Present when `FAILED`.
    - `code` string
    - `message` string
    - `failed_case_ids` string[]

## Other responses

- `400`: Rejected by Meta and forwarded unchanged.
- `401`: Missing, invalid, or foreign-app token. Raised by Partner Portal before any forwarding.
- `429`: Per-app rate limit exceeded. Retry after the 60-second window.

---

[API](https://skmtc.dev/gupshup/apis/partner-portal-meta-business-agent-bizai-api.md) - [All operations](https://skmtc.dev/gupshup/apis/partner-portal-meta-business-agent-bizai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gupshup/apis/partner-portal-meta-business-agent-bizai-api/revisions/4c52185f2153?raw)