<!--
{
  "availability" : [
    "iOS: 26.0.0 -",
    "iPadOS: 26.0.0 -",
    "macOS: 26.0.0 -",
    "tvOS: 26.0.0 -",
    "visionOS: 26.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Vision",
  "identifier" : "/documentation/Vision/RecognizeDocumentsRequest",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "Vision"
    ],
    "preciseIdentifier" : "s:6Vision25RecognizeDocumentsRequestV"
  },
  "title" : "RecognizeDocumentsRequest"
}
-->

# RecognizeDocumentsRequest

An image-analysis request to scan an image of a document and provide information about its structure.

```
struct RecognizeDocumentsRequest
```

## Overview

This request scans a document and extracts different groups of text and barcodes within the document
image. Use this request to understand different types of structured texts like receipts, nutritional labels,
textbook pages, forms, or other documents that you want to understand in further detail.

The request generates a [`DocumentObservation`](/documentation/Vision/DocumentObservation) array, which allows you to access your chosen
document’s structure grouped by words, lines, or paragraphs. You can also access tables and lists that
appear in the document.

## Topics

### Creating a request

[`init(_:)`](/documentation/Vision/RecognizeDocumentsRequest/init(_:))

Creates a document content recognition request.

### Understanding the result

[`DocumentObservation`](/documentation/Vision/DocumentObservation)

Information about the sections of content that an image-analysis request detects in a document.

### Configuring a request

[`BarcodeDetectionOptions`](/documentation/Vision/RecognizeDocumentsRequest/BarcodeDetectionOptions-swift.struct)

A configuration object for detecting barcodes in a document.

[`TextRecognitionOptions`](/documentation/Vision/RecognizeDocumentsRequest/TextRecognitionOptions-swift.struct)

A configuration object for detected and recognized text within the document.

[`barcodeDetectionOptions`](/documentation/Vision/RecognizeDocumentsRequest/barcodeDetectionOptions-swift.property)

Configuration for detecting machine-readable codes in the document.

[`textRecognitionOptions`](/documentation/Vision/RecognizeDocumentsRequest/textRecognitionOptions-swift.property)

Configuration for recognizing text in the document.

[`supportedBarcodeSymbologies`](/documentation/Vision/RecognizeDocumentsRequest/supportedBarcodeSymbologies)

The collection of revisions the request supports.

[`supportedRecognitionLanguages`](/documentation/Vision/RecognizeDocumentsRequest/supportedRecognitionLanguages)

The identifiers of the languages that the request supports.

### Getting the revision

[`revision`](/documentation/Vision/RecognizeDocumentsRequest/revision-swift.property)

The request’s configured revision.

[`supportedRevisions`](/documentation/Vision/RecognizeDocumentsRequest/supportedRevisions)

The revisions supported by `ClassifyImageRequest`.

[`Revision`](/documentation/Vision/RecognizeDocumentsRequest/Revision-swift.enum)

A type that describes the algorithm or implementation that the request performs.

## Relationships

### Conforms To

[`CustomStringConvertible`](/documentation/Swift/CustomStringConvertible)

[`Sendable`](/documentation/Swift/Sendable)

[`SendableMetatype`](/documentation/Swift/SendableMetatype)

[`Equatable`](/documentation/Swift/Equatable)

[`ImageProcessingRequest`](/documentation/Vision/ImageProcessingRequest)

[`Hashable`](/documentation/Swift/Hashable)

[`VisionRequest`](/documentation/Vision/VisionRequest)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)