---
title: "POST /evaluation/batch"
method: POST
path: "/evaluation/batch"
tags: ["evaluation"]
---

# POST /evaluation/batch

`POST /evaluation/batch`

## Request body

- EvaluationBatchRequest
  - `entities` EvaluationEntity[], required
    - `entityID` string
    - `entityType` string
    - `entityContext` object
  - `enableDebug` boolean
  - `flagIDs` integer[] — flagIDs
  - `flagKeys` string[] — flagKeys. Either flagIDs or flagKeys works. If pass in both, Flagr may return duplicate results.

## Response `200`

evaluation batch result

- EvaluationBatchResponse
  - `evaluationResults` EvalResult[], required
    - `flagID` integer
    - `flagKey` string
    - `flagSnapshotID` integer
    - `segmentID` integer
    - `variantID` integer
    - `variantKey` string
    - `variantAttachment` object
    - `evalContext` EvalContext
      - `entityID` string — entityID is used to deterministically at random to evaluate the flag result. If it's empty, flagr will randomly generate one.
      - `entityType` string
      - `entityContext` object
      - `enableDebug` boolean
      - `flagID` integer — flagID
      - `flagKey` string — flagKey. flagID or flagKey will resolve to the same flag. Either works.
    - `timestamp` string
    - `evalDebugLog` EvalDebugLog
      - `segmentDebugLogs` SegmentDebugLog[]
        - `segmentID` integer
        - `msg` string
      - `msg` string

## Other responses

- `default` — generic error response

---

[API](https://skmtc.dev/checkr/apis/flagr.md) · [All operations](https://skmtc.dev/checkr/apis/flagr/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/checkr/flagr/revisions/67717c0f1f1a/schema)