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

# POST /evaluate/v1/batch

`POST /evaluate/v1/batch`

## Request

- Base URL: `http://localhost:8080`
- URL: `http://localhost:8080/evaluate/v1/batch`
- Auth: HTTP bearer

## 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

- **2026-07-13** `6fe4caf26f13`: 1 info
  - added the optional property `responses/items/booleanResponse/segmentKeys` to the response with the `200` status
- **2024-08-08** `594afc3dbe2e`: 4 breaking, 13 warning
  - the `responses/items/booleanResponse/reason` response's property type changed from `integer` to `string` for status `200`
  - the `responses/items/errorResponse/reason` response's property type changed from `integer` to `string` for status `200`
  - the `responses/items/type` response's property type changed from `integer` to `string` for status `200`
  - the `responses/items/variantResponse/reason` response's property type changed from `integer` to `string` for status `200`
  - …13 more
- **2024-08-07** `291b2f802c58`: 4 breaking, 1 warning, 13 info
  - the `responses/items/booleanResponse/reason` response's property type changed from `string` to `integer` for status `200`
  - the `responses/items/errorResponse/reason` response's property type changed from `string` to `integer` for status `200`
  - the `responses/items/type` response's property type changed from `string` to `integer` for status `200`
  - the `responses/items/variantResponse/reason` response's property type changed from `string` to `integer` for status `200`
  - …14 more

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

---

[API](https://skmtc.dev/flipt-io/apis/flipt-api.md) - [All operations](https://skmtc.dev/flipt-io/apis/flipt-api/llms.txt) - [OpenAPI document](https://skmtc.dev/flipt-io/apis/flipt-api/revisions/6fe4caf26f13?raw)