---
title: "OFREP bulk flag evaluation contract"
method: POST
path: "/ofrep/v1/evaluate/flags"
---

# OFREP bulk flag evaluation contract

`POST /ofrep/v1/evaluate/flags`

OFREP bulk evaluation request

## Headers

- `If-None-Match` string

## Request body

- BulkEvaluationRequest — Evaluate multiple flags in one request
  - `context` Context — Context information for flag evaluation

## Response `200`

OFREP successful evaluation response

- BulkEvaluationSuccess — Success response for the bulk evaluation request
  - `flags` union[]
    - union
      - union
        - object — A boolean typed flag value
          - `key` string — Feature flag key
          - `reason` 'STATIC' | 'TARGETING_MATCH' | 'SPLIT' | 'DISABLED' | 'UNKNOWN' — An OpenFeature reason for the evaluation
          - `variant` string — Variant of the evaluated flag value
          - `metadata` object — Arbitrary metadata supporting flag evaluation
          - `value` boolean, required — Flag evaluation result
        - object — A string typed flag value
          - `key` string — Feature flag key
          - `reason` 'STATIC' | 'TARGETING_MATCH' | 'SPLIT' | 'DISABLED' | 'UNKNOWN' — An OpenFeature reason for the evaluation
          - `variant` string — Variant of the evaluated flag value
          - `metadata` object — Arbitrary metadata supporting flag evaluation
          - `value` string, required — Flag evaluation result
        - object — An integer typed flag value
          - `key` string — Feature flag key
          - `reason` 'STATIC' | 'TARGETING_MATCH' | 'SPLIT' | 'DISABLED' | 'UNKNOWN' — An OpenFeature reason for the evaluation
          - `variant` string — Variant of the evaluated flag value
          - `metadata` object — Arbitrary metadata supporting flag evaluation
          - `value` integer, required — Flag evaluation result
        - object — A float typed flag value
          - `key` string — Feature flag key
          - `reason` 'STATIC' | 'TARGETING_MATCH' | 'SPLIT' | 'DISABLED' | 'UNKNOWN' — An OpenFeature reason for the evaluation
          - `variant` string — Variant of the evaluated flag value
          - `metadata` object — Arbitrary metadata supporting flag evaluation
          - `value` number, required — Flag evaluation result
        - object — An object typed flag value
          - `key` string — Feature flag key
          - `reason` 'STATIC' | 'TARGETING_MATCH' | 'SPLIT' | 'DISABLED' | 'UNKNOWN' — An OpenFeature reason for the evaluation
          - `variant` string — Variant of the evaluated flag value
          - `metadata` object — Arbitrary metadata supporting flag evaluation
          - `value` object, required — Flag evaluation result
      - EvaluationFailure — Flag evaluation failure response
        - `key` string, required — Feature flag key
        - `errorCode` 'PARSE_ERROR' | 'TARGETING_KEY_MISSING' | 'INVALID_CONTEXT' | 'GENERAL', required — OpenFeature compatible error code. See https://openfeature.dev/specification/types#error-code
        - `errorDetails` string — An error description for logging or other needs

## Other responses

- `304` — Bulk evaluation is not modified
- `400` — Bad evaluation request
- `401` — Unauthorized - You need credentials to access the API
- `403` — Forbidden - You are not authorized to access the API
- `429` — Rate limit reached on the Flag Management System
- `500` — Internal server error

## Changes

- **2024-03-07** `2637da20b444` — 6 breaking, 7 warning, 6 info
  - the request's body type changed from `object` to no type
  - the response's body type changed from `object` to no type for status `400`
  - the response's body type changed from `object` to no type for status `500`
  - the response property `flags` became optional for the status `200`
  - …15 more

[Change history](https://skmtc.dev/open-feature/apis/openfeature-remote-evaluation-protocol-ofrep/changes/ofrep/v1/evaluate/flags/post.md)

---

[API](https://skmtc.dev/open-feature/apis/openfeature-remote-evaluation-protocol-ofrep.md) · [All operations](https://skmtc.dev/open-feature/apis/openfeature-remote-evaluation-protocol-ofrep/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/open-feature/openfeature-remote-evaluation-protocol-ofrep/revisions/786d3c1bbcfa/schema)