---
title: "Run a Validation node (raw verdicts)"
method: POST
path: "/v1/nodes/validate"
tags: ["Nodes"]
---

# Run a Validation node (raw verdicts)

`POST /v1/nodes/validate`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/nodes/validate`
- Auth: HTTP bearer

Validate a record set and return per-field verdicts. Supply a saved `validation_stage_id` or an inline `gate` config; default is structural evidence checks only (n-shot off, to bound cost). Raw mode — flagged cell status is written, but there are NO review-queue holds or field blocking (that governed flow stays on POST /v1/pipelines). Read verdicts from GET /v1/nodes/{id}/results.

## Request body

- object
  - `record_set_id` string, uuid, required
  - `schema_id` string, uuid, required
  - `validation_stage_id` string, uuid
  - `gate` object: Inline gate config: { evidence?, nshot?, llmJudge?, businessRules?, groundTruth? }

## Response `202`

Node job created and queued

- NodeRun: A standalone run of one One Engine phase over a record set.
  - `id` string, uuid
  - `node_type` 'transfer' | 'extraction' | 'resolution' | 'validation' | 'assembly'
  - `status` 'queued' | 'running' | 'completed' | 'partial' | 'error'
  - `record_set_id` string, uuid, nullable
  - `product_record_set_id` string, uuid, nullable
  - `total` integer
  - `completed` integer
  - `errors` integer
  - `error_message` string, nullable
  - `created_at` string, date-time
  - `links` object

## Other responses

- `400`: Invalid request
- `404`: Record set

---

[API](https://skmtc.dev/talonic/apis/talonic-api.md) · [All operations](https://skmtc.dev/talonic/apis/talonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talonic/apis/talonic-api/revisions/678fe5f8c9c3?raw)