---
title: "Create Evaluation."
method: POST
path: "/evaluations"
tags: ["Evaluations"]
---

# Create Evaluation.

`POST /evaluations`

Submit a new evaluation job.

## Request body

- EvaluationContract — A counterfactual evaluation.
  - `enableOfflineExperimentation` boolean — True if the evaluation should explore for a more optimal Learning settings.
  - `name` string, required — The name of the evaluation.
  - `startTime` string, date-time, required — The start time of the evaluation.
  - `endTime` string, date-time, required — The end time of the evaluation.
  - `policies` PolicyContract[], required — Additional Learning settings to evaluate.
    - `name` string, required — Name of the Learning settings.
    - `arguments` string, required — Arguments of the Learning settings.

## Response `201`

Success

- Evaluation
  - `id` string
  - `name` string
  - `startTime` string, date-time
  - `endTime` string, date-time
  - `jobId` string
  - `status` 'completed' | 'pending' | 'failed' | 'notSubmitted'
  - `policyResults` PolicyResult[]
    - `name` string
    - `arguments` string
    - `summary` PolicyResultSummary[]
      - `timeStamp` string, date-time
      - `ipsEstimatorNumerator` number, float
      - `ipsEstimatorDenominator` number, float
      - `snipsEstimatorDenominator` number, float
      - `aggregateTimeWindow` string, duration
      - `nonZeroProbability` number, float
      - `confidenceInterval` number, float
      - `sumOfSquares` number, float
    - `totalSummary` PolicyResultSummary
      - `timeStamp` string, date-time
      - `ipsEstimatorNumerator` number, float
      - `ipsEstimatorDenominator` number, float
      - `snipsEstimatorDenominator` number, float
      - `aggregateTimeWindow` string, duration
      - `nonZeroProbability` number, float
      - `confidenceInterval` number, float
      - `sumOfSquares` number, float
  - `featureImportance` array[]
    - string[]

## Other responses

- `default` — Invalid evaluation contract.

---

[API](https://skmtc.dev/azure/apis/personalizer-client.md) · [All operations](https://skmtc.dev/azure/apis/personalizer-client/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/personalizer-client/revisions/a086285ef734/schema)