---
title: "POST /evaluate/v1/batch"
method: POST
path: "/evaluate/v1/batch"
tags: ["EvaluationService"]
---

# POST /evaluate/v1/batch

`POST /evaluate/v1/batch`

## Request body

- BatchEvaluationRequest
  - `requestId` string
  - `requests` EvaluationRequest[], required
    - `requestId` string
    - `namespaceKey` string, required
    - `flagKey` string, required
    - `entityId` string, required
    - `context` object, required
    - `reference` string
  - `reference` string

## Response `200`

OK

- BatchEvaluationResponse
  - `requestId` string
  - `responses` EvaluationResponse[]
    - `type` 'VARIANT_EVALUATION_RESPONSE_TYPE' | 'BOOLEAN_EVALUATION_RESPONSE_TYPE' | 'ERROR_EVALUATION_RESPONSE_TYPE', enum
    - `booleanResponse` BooleanEvaluationResponse
      - `enabled` boolean
      - `reason` 'UNKNOWN_EVALUATION_REASON' | 'FLAG_DISABLED_EVALUATION_REASON' | 'MATCH_EVALUATION_REASON' | 'DEFAULT_EVALUATION_REASON', enum
      - `requestId` string
      - `requestDurationMillis` number, double
      - `timestamp` string, date-time
      - `flagKey` string
      - `segmentKeys` string[]
    - `variantResponse` VariantEvaluationResponse
      - `match` boolean
      - `segmentKeys` string[]
      - `reason` 'UNKNOWN_EVALUATION_REASON' | 'FLAG_DISABLED_EVALUATION_REASON' | 'MATCH_EVALUATION_REASON' | 'DEFAULT_EVALUATION_REASON', enum
      - `variantKey` string
      - `variantAttachment` string
      - `requestId` string
      - `requestDurationMillis` number, double
      - `timestamp` string, date-time
      - `flagKey` string
    - `errorResponse` ErrorEvaluationResponse
      - `flagKey` string
      - `namespaceKey` string
      - `reason` 'UNKNOWN_ERROR_EVALUATION_REASON' | 'NOT_FOUND_ERROR_EVALUATION_REASON', enum
  - `requestDurationMillis` number, double

## Changes

> 5 revisions in range; 1 could not be searched.

- **2024-08-08** `594afc3dbe2e` — 4 breaking, 13 warning
  - the `responses/items/booleanResponse/reason` response's property type/format changed from `integer`/`enum` to `string`/`enum` for status `200`
  - the `responses/items/errorResponse/reason` response's property type/format changed from `integer`/`enum` to `string`/`enum` for status `200`
  - the `responses/items/type` response's property type/format changed from `integer`/`enum` to `string`/`enum` for status `200`
  - the `responses/items/variantResponse/reason` response's property type/format changed from `integer`/`enum` to `string`/`enum` for status `200`
  - …13 more
- **2024-08-07** `291b2f802c58` — 4 breaking, 1 warning, 13 info
  - the `responses/items/booleanResponse/reason` response's property type/format changed from `string`/`enum` to `integer`/`enum` for status `200`
  - the `responses/items/errorResponse/reason` response's property type/format changed from `string`/`enum` to `integer`/`enum` for status `200`
  - the `responses/items/type` response's property type/format changed from `string`/`enum` to `integer`/`enum` for status `200`
  - the `responses/items/variantResponse/reason` response's property type/format changed from `string`/`enum` to `integer`/`enum` for status `200`
  - …14 more

[Change history](https://skmtc.dev/flipt-io/apis/api/changes/evaluate/v1/batch/post.md)

---

[API](https://skmtc.dev/flipt-io/apis/api.md) · [All operations](https://skmtc.dev/flipt-io/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/flipt-io/api/revisions/6fe4caf26f13/schema)