Skip to content
DecisionNodeDecisionNdedocs
  • Guides
  • API reference
  • Examples
  • Playground

start here

  • QuickstartGet startedGet an API key, send one request with three questions, and branch your code on the typed answers. Plain HTTPS, no SDK to install.
  • POST /v1/decideAPI referenceAnswer typed questions about a state and optional images. One request, one buffered JSON response, one answer per question.
  • QuestionsConceptsQuestions say what to decide. Each one has a type that fixes the shape of its answer: a choice from your options, a score on your scale, a…
  • ConfidenceConceptsProbabilities are calibrated per question type, so a threshold means what it says.
  • ImagesConceptsSend images and text in the same request. The model reads printed and handwritten text, amounts, dates, objects and layout, and answers…
  • Pricing and billingYou pay for input tokens only. Output is free because the model generates no text.
↑↓ moveopen6 suggestions
Get API keyGet API key
DecisionNodeDecisionNde

Get started

  • Introduction
  • Quickstart
  • With coding agents
  • Examples

Concepts

  • State
  • Questions
  • Choice
  • Score
  • Truth
  • Number
  • Images
  • Confidence
  • Determinism

Models

  • DecisionNode-1.0
  • DecisionNode-1.0 Flash
  • Limits

Patterns

  • Confidence-gated routing
  • Fan-out
  • Guardrails
  • Control loopscomingcoming soon

API reference

  • POST/v1/decide
  • POST/v1/sessionscomingcoming soon
  • GET/v1/models
  • Errors
  • Rate limits

Pricing and billing

  • Pricing and billing

Policies

  • Responsible use

Migrate

  • Coming from a Jev-shaped API
  • Benchmarks
  • Pricing
  • Playground
Get API key
  • Guides
  • API reference
  • Examples
  • Playground

Get started

  • Introduction
  • Quickstart
  • With coding agents
  • Examples

Concepts

  • State
  • Questions
  • Choice
  • Score
  • Truth
  • Number
  • Images
  • Confidence
  • Determinism

Models

  • DecisionNode-1.0
  • DecisionNode-1.0 Flash
  • Limits

Patterns

  • Confidence-gated routing
  • Fan-out
  • Guardrails
  • Control loopscomingcoming soon

API reference

  • POST/v1/decide
  • POST/v1/sessionscomingcoming soon
  • GET/v1/models
  • Errors
  • Rate limits

Pricing and billing

  • Pricing and billing

Policies

  • Responsible use

Migrate

  • Coming from a Jev-shaped API
  1. docs
  2. /
  3. API reference

GET /v1/models

List the model names your key can send, each with the pinned version it answers from today and its limits.

GEThttps://api.decisionnode.com/v1/models
curl https://api.decisionnode.com/v1/models \
  -H "Authorization: Bearer $DECISIONNODE_API_KEY"

Headers#

Authorizationstringrequired
Bearer dn_live_.... The request has no body and no parameters; the list depends only on your key.

Call it once at startup to check a key and to log which pinned version decisionnode-latest answers from. It sends no tokens, so it costs nothing.

Response body#

JSON
{
  "models": [
    {
      "name": "decisionnode-latest",
      "description": "Our most accurate decision model",
      "release_date": "2026-10-01",
      "version": "decisionnode-1.0",
      "context_tokens": 65536,
      "max_images": 4,
      "max_choices": 255,
      "max_levels": 10
    },
    {
      "name": "decisionnode-flash-latest",
      "description": "The fastest and cheapest tier",
      "release_date": "2026-10-01",
      "version": "decisionnode-1.0-flash",
      "context_tokens": 65536,
      "max_images": 4,
      "max_choices": 255,
      "max_levels": 10
    }
  ]
}
modelsarray
One entry per name your key may send.
namestring
What you send as model.
descriptionstring
What the model is for.
release_datestring
When this name started answering, as YYYY-MM-DD.
versionstring
The pinned version the name answers from today. Send it as model to pin.
context_tokensnumber
Maximum tokens per request, 65,536.
max_imagesnumber
Images per request.
max_choicesnumber
Options per choice question.
max_levelsnumber
Levels per score question.

Prices per million input tokens are on Pricing and billing. Code that reads only name, description and release_date keeps working: the other fields are extra.

When sessions comingcoming soon ship, this list also publishes how many sessions your key may hold open.

  1. Headers
  2. Response body
request
curl https://api.decisionnode.com/v1/models \  -H "Authorization: Bearer $DECISIONNODE_API_KEY"
previousSessionscomingcoming soonnextErrors

DecisionNode is built and run by Bynn Intelligence, Inc.

  • Home
  • Playground
  • Examples
  • Console
  • Responsible use
  • Terms
  • Acceptable use
  • Privacy
  • Data processing
  • Defence addendum
  • Cookies