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, nothing to install.
  • POST /v1/decideAPI referenceAnswer typed questions about a state, optional images and video frames. 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 on the data we measure.
  • ImagesConceptsSend up to 16 images and text in the same request. The model reads printed and handwritten text, amounts, dates, objects and layout, and…
  • Batch jobsPatternsSend up to 10,000 requests in one file and collect the answers later, at a lower price than live calls.
  • Pricing and billingEvery workspace runs on a plan: Starter, Pro, Business or Dedicated.
↑↓ moveopen7 suggestions
Get API keyGet API key
DecisionNodeDecisionNde

Get started

  • Introduction
  • Quickstart
  • CLI
  • Playground
  • Console and keys
  • With coding agents
  • MCP server
  • Examples

Concepts

  • State
  • Questions
  • Choice
  • Score
  • Truth
  • Number
  • Points and boxes
  • Images
  • Video
  • Boosters
  • Collections
  • Confidence
  • Determinism
  • API keys

Knowledge

  • Overview
  • Documents
  • In a decision
  • Pricing and your data
  • When a rule does not appear

Models

  • DecisionNode
  • DecisionNode Flash
  • DecisionNode Edge
  • Limits
  • Versions
  • Dedicated capacity

Fine-tuning

  • Overview
  • Prepare your dataset
  • Upload and validation
  • Start a training run
  • Watch a run
  • The quality gate
  • Use your model
  • Limits and pricing

Patterns

  • Confidence-gated routing
  • Form router
  • Fan-out
  • Guardrails
  • Control loops
  • Batch jobs
  • Keys on devices
  • Bill your customers per device
  • Publishable keys

Integrations

  • Home Assistant
  • MQTT bridge
  • ROS 2

API reference

  • Overview
  • POST/v1/decide
  • POST/v1/systemone
  • GET/v1/models
  • POST/v1/uploads
  • /v1/keys
  • GET/v1/keys/{key_id}/usage
  • GET/v1/usage
  • POST/v1/credit
  • Errors
  • Safety check
  • Rate limits

Sessions API

  • Sessions overview
  • POSTOpen a session
  • WSStream frames
  • DELEnd a session

Collections API

  • Overview
  • POSTCreate a collection
  • GETList collections
  • GETRetrieve a collection
  • DELDelete a collection
  • POSTEnroll a face
  • GETList items
  • PATCHUpdate an item
  • DELDelete an item
  • POSTAdd a document
  • PUTReplace a document
  • GETRetrieve an item
  • GETList passages
  • DELDelete failed documents
  • POSTSearch a knowledge base

Batch API

  • The batch object
  • POSTCreate a batch
  • POSTAdd requests
  • POSTFinalize a batch
  • GETRetrieve a batch
  • GETGet batch results
  • POSTCancel a batch
  • GETList batches

Pricing and billing

  • Pricing and billing
  • Refer & earn

Policies

  • Responsible use
  • Data and privacy
  • Benchmarks
  • Pricing
  • Playground
Get API key
  • Guides
  • API reference
  • Examples
  • Playground

Get started

  • Introduction
  • Quickstart
  • CLI
  • Playground
  • Console and keys
  • With coding agents
  • MCP server
  • Examples

Concepts

  • State
  • Questions
  • Choice
  • Score
  • Truth
  • Number
  • Points and boxes
  • Images
  • Video
  • Boosters
  • Collections
  • Confidence
  • Determinism
  • API keys

Knowledge

  • Overview
  • Documents
  • In a decision
  • Pricing and your data
  • When a rule does not appear

Models

  • DecisionNode
  • DecisionNode Flash
  • DecisionNode Edge
  • Limits
  • Versions
  • Dedicated capacity

Fine-tuning

  • Overview
  • Prepare your dataset
  • Upload and validation
  • Start a training run
  • Watch a run
  • The quality gate
  • Use your model
  • Limits and pricing

Patterns

  • Confidence-gated routing
  • Form router
  • Fan-out
  • Guardrails
  • Control loops
  • Batch jobs
  • Keys on devices
  • Bill your customers per device
  • Publishable keys

Integrations

  • Home Assistant
  • MQTT bridge
  • ROS 2

API reference

  • Overview
  • POST/v1/decide
  • POST/v1/systemone
  • GET/v1/models
  • POST/v1/uploads
  • /v1/keys
  • GET/v1/keys/{key_id}/usage
  • GET/v1/usage
  • POST/v1/credit
  • Errors
  • Safety check
  • Rate limits

Sessions API

  • Sessions overview
  • POSTOpen a session
  • WSStream frames
  • DELEnd a session

Collections API

  • Overview
  • POSTCreate a collection
  • GETList collections
  • GETRetrieve a collection
  • DELDelete a collection
  • POSTEnroll a face
  • GETList items
  • PATCHUpdate an item
  • DELDelete an item
  • POSTAdd a document
  • PUTReplace a document
  • GETRetrieve an item
  • GETList passages
  • DELDelete failed documents
  • POSTSearch a knowledge base

Batch API

  • The batch object
  • POSTCreate a batch
  • POSTAdd requests
  • POSTFinalize a batch
  • GETRetrieve a batch
  • GETGet batch results
  • POSTCancel a batch
  • GETList batches

Pricing and billing

  • Pricing and billing
  • Refer & earn

Policies

  • Responsible use
  • Data and privacy
  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.

on this page5 sections
  1. Headers
  2. Response body
  3. Names in the list
  4. Fine-tuned models
  5. Errors
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's workspace. It answers a workspace that is out of credit or suspended too, and it is not rate limited.

Call it once at startup to check a key and to log which pinned version decisionnode answers from. It sends no tokens, so it costs nothing. The answer carries Cache-Control: private, max-age=60.

Response body#

JSON
{
  "models": [
    {
      "name": "decisionnode",
      "description": "Our most accurate decision model",
      "release_date": "2026-10-01",
      "display_name": "DecisionNode",
      "short_name": "DecisionNode",
      "version": "decisionnode-main-0.9.1-rc1",
      "current_version": "decisionnode-main-0.9.1-rc1",
      "alias": "decisionnode",
      "price_per_million_input": 0.042,
      "price_per_million_output": 0,
      "price_per_million_image": 0.09,
      "price_per_million_video": 0.09,
      "batch_price_factor": 0.7,
      "context_tokens": 65536,
      "max_images": 16,
      "max_choices": 255,
      "max_levels": 10,
      "number_one_question_values": 256,
      "number_max_grid_values": 4096,
      "number_default_range": [0, 255],
      "number_default_step": 1,
      "upload_max_bytes": 10485760,
      "upload_ttl_seconds": 3600,
      "upload_media_types": ["image/jpeg", "image/png", "image/webp"],
      "videos": { "max_videos": 4, "max_frames_request": 128 },
      "batch": {
        "requests_per_batch": 10000,
        "batch_bytes": 268435456,
        "add_bytes": 10485760,
        "active_batches_per_key": 10,
        "queued_requests_per_key": 100000,
        "time_to_completion_hours": 24,
        "result_retention_days": 7,
        "max_custom_id_chars": 512
      }
    },
    {
      "name": "decisionnode-flash",
      "description": "The fastest and cheapest tier",
      "release_date": "2026-10-01",
      "display_name": "DecisionNode Flash",
      "short_name": "DecisionNode Flash",
      "version": "decisionnode-flash-0.9.1-rc1",
      "current_version": "decisionnode-flash-0.9.1-rc1",
      "alias": "decisionnode-flash",
      "price_per_million_input": 0.035,
      "price_per_million_output": 0,
      "price_per_million_image": 0.08,
      "price_per_million_video": 0.08,
      "batch_price_factor": 0.5,
      "context_tokens": 65536,
      "max_images": 16,
      "max_choices": 255,
      "max_levels": 10,
      "number_one_question_values": 256,
      "number_max_grid_values": 4096,
      "number_default_range": [0, 255],
      "number_default_step": 1,
      "upload_max_bytes": 10485760,
      "upload_ttl_seconds": 3600,
      "upload_media_types": ["image/jpeg", "image/png", "image/webp"],
      "videos": { "max_videos": 4, "max_frames_request": 128 },
      "batch": {
        "requests_per_batch": 10000,
        "batch_bytes": 268435456,
        "add_bytes": 10485760,
        "active_batches_per_key": 10,
        "queued_requests_per_key": 100000,
        "time_to_completion_hours": 24,
        "result_retention_days": 7,
        "max_custom_id_chars": 512
      }
    }
  ]
}
modelsarray
One entry per name your key may send.
namestring
What you send as model: a family id, a pinned id, or one of your workspace's fine-tuned models.
descriptionstring
What the model is for.
display_namestring
The model's name for people, such as DecisionNode. Show this in your own UI; send name.
short_namestring
A short name for people, such as DecisionNode Flash.
release_datestring
When this name started answering, as YYYY-MM-DD; a pinned entry carries its family entry's.
versionstring
The pinned version the name answers from today: on a family's entry, its current version (else the newest our servers report, else the family id itself); on a pinned id's own entry, name itself. Send it as model to pin.
current_versionstring or null
Family entries only: the pinned version as version names it, or null while no server reports one.
aliasstring
The family id, such as decisionnode: on a family's entry its own id, on a pinned entry the family the version belongs to. Fine-tuned entries carry none.
price_per_million_inputnumber
The price per million input tokens, in USD.
price_per_million_outputnumber
Always 0: the model writes no text, so output is free.
price_per_million_imagenumber or null
The price per million image tokens, in USD; null when none is set. No fee per image.
price_per_million_videonumber or null
The price per million video tokens, in USD; null when none is set. No fee per frame.
batch_price_factornumber
The share of the live prices a batch line pays, from 0 to 1: 0.7 on DecisionNode (30% off), 0.5 on DecisionNode Flash (50% off).
scheduledarray
The changes due within 30 days, soonest first, each {"field", "value", "effective_from"}: a price field and its new value, such as {"field": "price_per_million_input", "value": 0.038, "effective_from": "..."}. A family's version is never scheduled: it moves when our servers serve a newer version. Left out when nothing is scheduled. Fine-tuned entries carry none.
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.
number_one_question_valuesnumber
Grid values a number question answers as one question, 256. Finer or wider grids are composed in the same call.
number_max_grid_valuesnumber
The most values a number question's grid may hold in all, 4,096. A larger grid is a 422.
number_default_rangearray
The min and max of a number question that leaves them out, [0, 255].
number_default_stepnumber
The step of a number question that leaves it out, 1.
upload_max_bytes, upload_ttl_seconds, upload_media_typesnumber, number, array
What an upload of this model takes: its largest picture in bytes, how long it lives in seconds, and its media types.
videosobject
The video limits: max_videos (4) and max_frames_request (128), the smaller of ours and the model server's, and whatever else the server publishes about frames.
placesobject
Only when the version's servers answer several places: {"max_places": n}, the most a point or box question may ask for. Absent otherwise.
batchobject
The limits of batch jobs on this model; their price is batch_price_factor.
requests_per_batchnumber
Requests one batch may hold, 10,000.
batch_bytesnumber
The largest upload per batch, in bytes (256 MiB).
add_bytesnumber
The largest add call, in bytes (10 MiB).
active_batches_per_keynumber
Batches your key may hold in draft, queued or running, 10.
queued_requests_per_keynumber
Requests your key may hold across its active batches, drafts included, 100,000.
time_to_completion_hoursnumber
Hours after finalize at which unfinished requests expire, unbilled, 24.
result_retention_daysnumber
Days results are kept after a batch ends, 7.
max_custom_id_charsnumber
The longest custom_id, 512 characters.
fine_tunedboolean
Only on your workspace's fine-tuned models: true. Our own models' entries do not carry it.
basestring
Fine-tuned entries only: the family it was trained from, such as decisionnode.
base_versionstring
Fine-tuned entries only: the pinned base version it was trained on.
familystring
Fine-tuned entries only: the same family id as base.
adapter_versioninteger
Fine-tuned entries only: the version number; on a plain name, the version it answers from. version stays the pinned name.
statusstring
Fine-tuned entries only: deployed, or ready (trained and passed its gate, not deployed: its name is refused).
  1. Headers
  2. Response body
  3. Names in the list
  4. Fine-tuned models
  5. Errors
request
curl https://api.decisionnode.com/v1/models \  -H "Authorization: Bearer $DECISIONNODE_API_KEY"

Names in the list#

The list holds one entry for every name your key may send. Our own models' entries carry the same fields; a fine-tuned entry differs (below). The sample above shows the first two; the full list today is:

  • decisionnode

    What it is
    DecisionNode, the family. Its version is decisionnode-main-0.9.1-rc1 today and moves with each release
  • decisionnode-flash

    What it is
    DecisionNode Flash, the family. Its version is decisionnode-flash-0.9.1-rc1 today and moves with each release
  • decisionnode-main-0.9.1-rc1

    What it is
    DecisionNode, pinned. Its version is its own name and never changes; its alias is decisionnode
  • decisionnode-flash-0.9.1-rc1

    What it is
    DecisionNode Flash, pinned. Its version is its own name and never changes; its alias is decisionnode-flash
The entries of GET /v1/models today
nameWhat it is
decisionnodeDecisionNode, the family. Its version is decisionnode-main-0.9.1-rc1 today and moves with each release
decisionnode-flashDecisionNode Flash, the family. Its version is decisionnode-flash-0.9.1-rc1 today and moves with each release
decisionnode-main-0.9.1-rc1DecisionNode, pinned. Its version is its own name and never changes; its alias is decisionnode
decisionnode-flash-0.9.1-rc1DecisionNode Flash, pinned. Its version is its own name and never changes; its alias is decisionnode-flash

A pinned id is its own entry, whose version equals its name and whose alias names its family. To find what a family id answers from, read its entry's version. The pinned entries are the versions our servers report, at most 16 a family: a version stays listed while a server still reports it (see Versions and retirement). Earlier ids that are still accepted as model are not listed.

The list names the hosted models only. DecisionNode Edge, the open-weight System One models you run on your own hardware, is never listed and is not sent as model: its runtime answers on your machine.

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.

Read the batch object before you size an upload: code that reads it keeps working when the values change.

A family's version changes when we release a new version; a pinned id never changes. How long a version stays available, and how to move to a new one, is on Versions and retirement.

Fine-tuned models#

For a key of a workspace that has fine-tuned models, the list also holds the plain name of every model with a deployed version, and every deployed or ready version under its pinned name. Only deployed entries answer; a ready one is trained and passed its gate, and sending its name is the 400 Unknown model until you deploy it. Each entry carries the base's limits, as the base's own entry does. Another workspace's keys never see them.

A fine-tuned entry
{
  "name": "decisionnode-flash@acme/fraud:3",
  "description": "Claims fraud, trained on 2,400 decisions",
  "release_date": "2026-10-09",
  "version": "decisionnode-flash@acme/fraud:3",
  "fine_tuned": true,
  "base": "decisionnode-flash",
  "base_version": "decisionnode-flash-0.9.1-rc1",
  "family": "decisionnode-flash",
  "adapter_version": 3,
  "status": "deployed",
  "context_tokens": "65,536",
  "max_images": "16",
  "max_choices": "255",
  "max_levels": "10"
}
  • version is the pinned name the entry answers from, as on every entry: on the plain name decisionnode-flash@acme/fraud it is the version deployed most recently.
  • description is the one set in the console, else Fine-tuned from and the base's name; release_date is the day the version finished training.
  • Match on fine_tuned, not on the shape of the name, to tell your models from ours.
  • A fine-tuned entry differs: it carries base_version and no alias, batch, batch_price_factor or scheduled; its display_name and short_name are your model's name; its prices are its family's current prices plus the serving premium.

Errors#

  • 401

    Type
    authentication_error
    When
    The key is missing, unknown or revoked
    What to do
    Check the Authorization header
  • 405

    Type
    method_not_allowed_error
    When
    Another method than GET; Allow: GET
    What to do
    Send a GET
  • 500

    Type
    api_error
    When
    A fault on our side
    What to do
    Retry with backoff
  • 529

    Type
    overloaded_error
    When
    No capacity right now
    What to do
    Wait Retry-After, then retry
Errors this endpoint returns
StatusTypeWhenWhat to do
401authentication_errorThe key is missing, unknown or revokedCheck the Authorization header
405method_not_allowed_errorAnother method than GET; Allow: GETSend a GET
500api_errorA fault on our sideRetry with backoff
529overloaded_errorNo capacity right nowWait Retry-After, then retry
previousPOST /v1/systemonenextPOST /v1/uploads

DecisionNode is built and run by Bynn Intelligence, Inc.

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