> ## Documentation Index > Fetch the complete documentation index at: https://docs.ndi.nace.ai/llms.txt > Use this file to discover all available pages before exploring further. # evaluate_systemone > Answer typed questions about a state in one call, with probabilities. Each question is a yes/no (`noul`), a pick among named options (`choice`), or a position on an ordered scale (`score`). Nothing is stored and no job is created. A deployment without a decision model answers `501 not_implemented`. ## OpenAPI ````yaml /openapi.json post /v1/systemone openapi: 3.1.0 info: description: >- Document intelligence: parse, split, classify, extract, and ground files, or build a searchable workspace. Authenticate with ``X-API-Key``. title: NDI Platform API version: 0.1.0 servers: - url: https://ndi-api.nace.ai security: [] tags: [] paths: /v1/systemone: post: tags: - systemone summary: evaluate_systemone description: >- Answer typed questions about a state in one call, with probabilities. Each question is a yes/no (`noul`), a pick among named options (`choice`), or a position on an ordered scale (`score`). Nothing is stored and no job is created. A deployment without a decision model answers `501 not_implemented`. operationId: evaluate_systemone_v1_systemone_post requestBody: content: application/json: schema: $ref: '#/components/schemas/SystemOneRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/SystemOneResponse' description: Successful Response default: content: application/json: example: error: code: invalid_request detail: null message: >- Request body has extra fields that this operation does not accept. request_id: req-01j9k2n3p4q5r6s7t8v9 retryable: false schema: $ref: '#/components/schemas/ErrorEnvelope' description: >- Typed error envelope used by every 4xx and 5xx. ``error.code`` distinguishes the failure; HTTP status is a consequence of the code. security: - APIKeyHeader: [] components: schemas: SystemOneRequest: additionalProperties: false properties: questions: additionalProperties: discriminator: mapping: choice: '#/components/schemas/ChoiceQuestion' noul: '#/components/schemas/NoulQuestion' score: '#/components/schemas/ScoreQuestion' propertyName: type oneOf: - $ref: '#/components/schemas/NoulQuestion' - $ref: '#/components/schemas/ChoiceQuestion' - $ref: '#/components/schemas/ScoreQuestion' description: >- The questions to answer in one call, keyed by the name each answer returns under. maxProperties: 512 minProperties: 1 propertyNames: minLength: 1 title: Questions type: object state: $ref: '#/components/schemas/JsonValue' description: >- The situation to decide about: text, or any JSON value such as a record or a list of rows. required: - state - questions title: SystemOneRequest type: object SystemOneResponse: additionalProperties: false properties: answers: additionalProperties: discriminator: mapping: choice: '#/components/schemas/ChoiceAnswer' noul: '#/components/schemas/NoulAnswer' score: '#/components/schemas/ScoreAnswer' propertyName: type oneOf: - $ref: '#/components/schemas/NoulAnswer' - $ref: '#/components/schemas/ChoiceAnswer' - $ref: '#/components/schemas/ScoreAnswer' description: One answer per question, keyed by the question's name. title: Answers type: object evaluation_time_ms: description: Time the decision model spent on the call, in milliseconds. title: Evaluation Time Ms type: number model: description: The decision model that answered, as this deployment names it. title: Model type: string request_id: anyOf: - type: string - type: 'null' description: Correlation id of this request, the same one error bodies carry. title: Request Id usage: $ref: '#/components/schemas/SystemOneUsage' description: Token usage of the decision call, for cost tracking. required: - model - answers - usage - evaluation_time_ms - request_id title: SystemOneResponse type: object ErrorEnvelope: description: Every non-2xx body on ``/v1``. example: error: code: invalid_request detail: null message: Request body has extra fields that this operation does not accept. request_id: req-01j9k2n3p4q5r6s7t8v9 retryable: false properties: error: $ref: '#/components/schemas/Error' required: - error title: ErrorEnvelope type: object ChoiceQuestion: additionalProperties: false description: >- Pick one of named options. Its answer is the chosen option and every option's probability. properties: criteria: additionalProperties: anyOf: - type: string - type: 'null' description: >- The options, keyed by the name the answer returns, each with an optional description. maxProperties: 255 minProperties: 1 propertyNames: minLength: 1 title: Criteria type: object instructions: anyOf: - type: string - type: 'null' description: The question that the options answer. title: Instructions type: const: choice title: Type type: string required: - type - criteria title: ChoiceQuestion type: object NoulQuestion: additionalProperties: false description: >- A yes/no question. Its answer is the probability that the statement is true. properties: criteria: anyOf: - $ref: '#/components/schemas/NoulCriteria' - type: 'null' description: Optional descriptions of the true and false outcomes. instructions: anyOf: - type: string - type: 'null' description: >- The question to decide. Needs instructions or at least one criterion. title: Instructions type: const: noul title: Type type: string required: - type title: NoulQuestion type: object ScoreQuestion: additionalProperties: false description: >- Place the state on an ordered scale. Its answer is a score along the levels. properties: criteria: description: The ordered levels of the scale, lowest first. items: type: string maxItems: 255 minItems: 1 title: Criteria type: array instructions: anyOf: - type: string - type: 'null' description: The question that the scale answers. title: Instructions type: const: score title: Type type: string required: - type - criteria title: ScoreQuestion type: object JsonValue: {} ChoiceAnswer: additionalProperties: false properties: choice: description: The most probable option, by its key in the question's criteria. title: Choice type: string confidence: description: >- The decision model's average confidence in this answer, from 0 to 1. It tracks the chosen option's probability but is a separate number; do not derive one from the other. title: Confidence type: number probabilities: additionalProperties: type: number description: Every option's probability, keyed by option name. title: Probabilities type: object type: const: choice default: choice title: Type type: string required: - choice - confidence - probabilities title: ChoiceAnswer type: object NoulAnswer: additionalProperties: false properties: noul: description: Probability, from 0 to 1, that the statement is true. title: Noul type: number type: const: noul default: noul title: Type type: string required: - noul title: NoulAnswer type: object ScoreAnswer: additionalProperties: false properties: confidence: description: >- The decision model's average confidence in this answer, from 0 to 1. Lower means it was less sure; it is not the probability of any one level. title: Confidence type: number legend: description: >- The scale's levels in order, lowest first, as the question named them. items: type: string title: Legend type: array probabilities: additionalProperties: type: number description: Each level's probability, keyed by its index in the legend. title: Probabilities type: object score: description: >- Expected position on the scale, from 0 (the first level) to the last level's index. title: Score type: number type: const: score default: score title: Type type: string required: - score - legend - probabilities - confidence title: ScoreAnswer type: object SystemOneUsage: additionalProperties: false properties: input_tokens: anyOf: - type: integer - type: 'null' description: Tokens the decision model read, when the model reports them. title: Input Tokens output_tokens: anyOf: - type: integer - type: 'null' description: Tokens the decision model produced, when the model reports them. title: Output Tokens required: - input_tokens - output_tokens title: SystemOneUsage type: object Error: description: The error object, per spec 12 §1.8. properties: code: $ref: '#/components/schemas/ErrorCode' detail: anyOf: - additionalProperties: true type: object - type: 'null' description: Structured payload, when the code carries one. title: Detail message: description: Human- and model-readable; says what to do differently. title: Message type: string request_id: anyOf: - type: string - type: 'null' description: >- Per-request correlation id; matches the ``X-Request-Id`` header. Null only when the error was minted outside any HTTP request, e.g. by a worker. title: Request Id retryable: description: Whether retrying the identical request could succeed. title: Retryable type: boolean required: - code - message - retryable title: Error type: object NoulCriteria: additionalProperties: false properties: 'false': anyOf: - type: string - type: 'null' description: What makes the statement false, in the caller's words. title: 'False' 'true': anyOf: - type: string - type: 'null' description: What makes the statement true, in the caller's words. title: 'True' title: NoulCriteria type: object ErrorCode: description: |- Every error the ``/v1`` surface can return. Clients must treat this as an **open** enum: a new member is an additive change (spec 12 §9), and a client that crashes on an unknown code makes every future error a breaking change. enum: - invalid_request - unsupported_file_type - file_too_large - invalid_schema - invalid_sql - invalid_path_prefix - command_not_permitted - batch_too_large - domain_validation_failed - default_label_required - wait_required_for_zero_retention - ledger_decision_invalid - tenant_required - partner_required - workspace_not_found - file_not_found - job_not_found - upload_not_found - node_not_found - schema_not_found - domain_not_found - session_not_found - access_label_not_found - ledger_understanding_not_found - ledger_table_not_found - tenant_not_found - path_conflict - schema_version_conflict - access_label_name_taken - workspace_name_taken - access_label_in_use - upload_expired - file_not_ingested - workspace_deleting - workspace_not_deletable - ingestion_in_progress - job_not_cancellable - confirmation_required - domain_not_published - domain_in_use - reserved_domain_slug - kg_not_built - kg_build_in_progress - ledger_understanding_in_progress - ledger_understanding_version_outdated - session_busy - tenant_limit_reached - range_not_satisfiable - result_expired - access_denied - tenant_disabled - access_backstop_violation - access_mode_not_implemented - rate_limited - concurrency_limit_reached - quota_exceeded - corrupt_file - zero_byte_file - encrypted_file - csv_dialect_ambiguous - csv_parse_failed - parse_failed - ocr_failed - conversion_failed - sheetless_workbook - unplayable_media - unclassified_pages - job_cancelled - job_timeout - upstream_unavailable - internal_error - unauthorized - not_implemented title: ErrorCode type: string securitySchemes: APIKeyHeader: in: header name: X-API-Key type: apiKey ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.