---
title: "application.listCriteriaEvaluations"
method: POST
path: "/application.listCriteriaEvaluations"
tags: ["Application"]
---

# application.listCriteriaEvaluations

`POST /application.listCriteriaEvaluations`

Fetch a paginated list of AI criteria evaluations for an application.

This endpoint returns the AI-generated criteria evaluations that assess how well a candidate meets specific job requirements. Each evaluation contains the outcome, reasoning, and other assessment details.

This endpoint supports pagination only (not incremental sync). See the [Pagination and Incremental Synchronization](/docs/pagination-and-incremental-sync) guide for usage examples.

**Note:** This endpoint requires the AI Application Review feature to be enabled for your organization.

**Requires the [`candidatesRead`](authentication#permissions-applicationlistcriteriaevaluations) permission.**

## Request body

- ApplicationListCriteriaEvaluationsRequest
  - `applicationId` string, uuid, required — The id of the application to fetch criteria evaluations for.
  - `cursor` string, nullable — The pagination cursor. Use 'start' for the first page or the nextCursor value from a previous response.
  - `limit` number, nullable — The maximum number of criteria evaluations to return per page.

## Response `200`

Responses from the application.listCriteriaEvaluations endpoint

- union
  - ApplicationListCriteriaEvaluationsSuccessResponse
    - `success` true, required
    - `results` ApplicationCriteriaEvaluation[], required
      - `id` string, uuid, required — The id of the criteria evaluation.
      - `criterion` object, required — The criterion that was evaluated.
        - `id` string, uuid, required — The id of the criterion version.
        - `title` string, required — The title of the criterion.
        - `type` 'ResumePrompt' | 'DidAnswerApplicationFormQuestion' | 'SimilarityToAiGeneratedAnswer', required — The type of criterion evaluation.
        - `prompt` string, nullable — The prompt text used for AI evaluation.
        - `applicationFormDefinitionId` string, uuid, nullable — The id of the application form definition (if applicable).
        - `applicationFormFieldPath` string, nullable — The path to the specific application form field (if applicable).
      - `status` 'Pending' | 'Completed' | 'Failed' | 'Skipped', required — The status of the evaluation.
      - `outcome` string, nullable — The evaluation outcome (e.g., "Meets", "Does Not Meet").
      - `reasoning` string, nullable — The AI's reasoning for the evaluation outcome.
      - `skipReason` string, nullable — The reason why the evaluation was skipped (if status is "Skipped").
      - `outcomeNumber` number, nullable — A numerical score representing the evaluation outcome (0.0 to 1.0).
      - `evaluatedAt` string, date-time, nullable — The date and time when the evaluation was completed.
    - `nextCursor` string — Cursor for the next page of results, if available
    - `moreDataAvailable` boolean — Whether more data is available beyond this page
    - `syncToken` string — Sync token to use for future incremental syncs. Only present on the last page.
  - ErrorResponse
    - `success` false, required
    - `errors` ErrorDetail[], required
      - `message` string, required
      - `parameter` string

---

[API](https://skmtc.net/ashbyhq/apis/ashby-api.md) · [All operations](https://skmtc.net/ashbyhq/apis/ashby-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ashbyhq/ashby-api/revisions/778b919dc743/schema)