---
title: "UnparseableOutputHandling"
canonical_url: "https://www.nutrient.io/api/python/enums/unparseable-output-handling/"
md_url: "https://www.nutrient.io/api/python/enums/unparseable-output-handling.md"
last_updated: "2026-09-02T11:19:46.684Z"
description: "How AI extraction responds when the model's output never parses against the requested schema (all retry attempts exhausted)."
---

How AI extraction responds when the model's output never parses against the requested schema (all retry attempts exhausted).

```python

from nutrient_sdk import UnparseableOutputHandling

```

## Values

| Name                                     | Value | Description                                                                                                                                                                                                                           |
| ---------------------------------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `UnparseableOutputHandling.DEFAULT`      | `0`   | Each API surface keeps its own default: the SDK's structured-extraction API fails the call with a descriptive error; server pipelines (daemon actions, DWS) return an empty result with the failure recorded in diagnostics warnings. |
| `UnparseableOutputHandling.FAIL`         | `1`   | Fail the extraction call with an error naming the parse failure and an excerpt of the content that arrived. A wrong or empty result is never reported as success.                                                                     |
| `UnparseableOutputHandling.RETURN_EMPTY` | `2`   | Return an empty extraction result and record the failure in diagnostics warnings — keeps batch pipelines running when individual documents fail.                                                                                      |

## Usage Example

```python

from nutrient_sdk import UnparseableOutputHandling

# Access enum values

value = UnparseableOutputHandling.DEFAULT
print(f"Value: {value}")  # Output: Value: UnparseableOutputHandling.DEFAULT

print(f"Integer value: {value.value}")  # Output: Integer value: 0

```

---

## Related pages

- [All public classes import directly from the top-level package:](/api/python/enums.md)
- [Access enum values](/api/python/enums/auto-tagging-engine.md)
- [Access enum values](/api/python/enums/description-level.md)
- [Access enum values](/api/python/enums/document-bookmark-source.md)
- [Access enum values](/api/python/enums/document-format.md)
- [Access enum values](/api/python/enums/document-markup-mode.md)
- [Access enum values](/api/python/enums/document-type.md)
- [Access enum values](/api/python/enums/execution-provider.md)
- [Access enum values](/api/python/enums/html-layout-type.md)
- [Access enum values](/api/python/enums/image-export-format.md)
- [Access enum values](/api/python/enums/image-export-mode.md)
- [Access enum values](/api/python/enums/image-setting-mode.md)
- [Access enum values](/api/python/enums/implicit-conversion.md)
- [Access enum values](/api/python/enums/instant-json-render-theme.md)
- [Access enum values](/api/python/enums/json-export-content.md)
- [Access enum values](/api/python/enums/json-export-format.md)
- [Access enum values](/api/python/enums/ocr-activation-mode.md)
- [Access enum values](/api/python/enums/open-settings-mode.md)
- [Access enum values](/api/python/enums/page-cache-mode.md)
- [Access enum values](/api/python/enums/pdf-border-style.md)
- [Access enum values](/api/python/enums/pdf-compression.md)
- [Access enum values](/api/python/enums/pdf-conformance.md)
- [Access enum values](/api/python/enums/pdf-form-field-type.md)
- [Access enum values](/api/python/enums/pdf-line-ending-style.md)
- [Access enum values](/api/python/enums/pdf-page-sizes.md)
- [Access enum values](/api/python/enums/pdf-rubber-stamp-icon.md)
- [Access enum values](/api/python/enums/pdf-save-preferences.md)
- [Access enum values](/api/python/enums/pdf-settings-mode.md)
- [Access enum values](/api/python/enums/pdf-validation-conformance.md)
- [Access enum values](/api/python/enums/rendering-layout-mode.md)
- [Access enum values](/api/python/enums/restoration-mode.md)
- [Access enum values](/api/python/enums/schema-compatibility.md)
- [Access enum values](/api/python/enums/search-display.md)
- [Access enum values](/api/python/enums/search-mode.md)
- [Access enum values](/api/python/enums/signature-certification-level.md)
- [Access enum values](/api/python/enums/signature-format.md)
- [Access enum values](/api/python/enums/signature-hash-algorithm.md)
- [Access enum values](/api/python/enums/signature-key-source.md)
- [Access enum values](/api/python/enums/signature-level.md)
- [Access enum values](/api/python/enums/text-direction.md)
- [Access enum values](/api/python/enums/tiff-compression.md)
- [Access enum values](/api/python/enums/unit-mode.md)
- [Access enum values](/api/python/enums/vision-engine.md)
- [Access enum values](/api/python/enums/vision-features.md)
- [Access enum values](/api/python/enums/vision-output-format.md)
- [Access enum values](/api/python/enums/vlm-classification-strategy.md)
- [Access enum values](/api/python/enums/vlm-provider.md)
- [Access enum values](/api/python/enums/word-refining-method.md)