---
title: "Evaluate questions against shared state"
method: POST
path: "/v1/evaluations"
tags: ["Evaluation"]
---

# Evaluate questions against shared state

`POST /v1/evaluations`

## Request

- Base URL: `https://api.neosantara.xyz`
- URL: `https://api.neosantara.xyz/v1/evaluations`
- Auth: HTTP bearer

Fast, structured decision-making and evaluation model endpoint (compatible with Vercel AI Gateway evaluate & TypeSafe Jev).

## Request body

- object
  - `model` string
  - `state` union, required
    - string
    - object
    - unknown[]
      - unknown
  - `questions` object, required

## Response `200`

Successful evaluation result

- object
  - `model` string, required
  - `answers` object, required
  - `usage` object
    - `inputTokens` number
    - `outputTokens` number

## Other responses

- `400`: Invalid request payload or question format
- `404`: Model not found
- `500`: Internal server error
- `503`: Upstream evaluation service unavailable

## Changes

- **2026-11-03** `f87af696a63e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/neosantara/apis/neosantara-ai-api/changes/v1/evaluations/post.md)

---

[API](https://skmtc.dev/neosantara/apis/neosantara-ai-api.md) - [All operations](https://skmtc.dev/neosantara/apis/neosantara-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/neosantara/apis/neosantara-ai-api/revisions/f87af696a63e?raw)