Document Intelligence SDK v3.1 latest (GA)

The SDKs referenced in this article are supported by: Document Intelligence checkmark Document Intelligence REST API version 2023-07-31—v3.1 (GA).

Azure AI Document Intelligence is a cloud service that uses machine learning to analyze text and structured data from documents. The Document Intelligence software development kit (SDK) is a set of libraries and tools that enable you to easily integrate Document Intelligence models and capabilities into your applications. Document Intelligence SDK is available across platforms in C#/.NET, Java, JavaScript, and Python programming languages.

Supported languages

Document Intelligence SDK supports the following languages and platforms:

Language → Document Intelligence SDK version            Package Supported API version           Platform support
.NET/C# → latest (GA) NuGet • 2023-07-31 (GA)
• 2022-08-31 (GA)
• v2.1
• v2.0
Windows, macOS, Linux, Docker
Java → latest (GA) MVN repository • 2023-07-31 (GA)
• 2022-08-31 (GA)
• v2.1
• v2.0
Windows, macOS, Linux
JavaScript → latest (GA) npm • 2023-07-31 (GA)
2022-08-31 (GA)
• v2.1
• v2.0
Browser, Windows, macOS, Linux
Python → latest (GA) PyPI • 2023-07-31 (GA)
2022-08-31 (GA)
• v2.1
• v2.0
Windows, macOS, Linux

Supported Clients

The following tables present the correlation between each SDK version the supported API versions of the Document Intelligence service.

Language SDK version API version (default)            Supported clients
.NET/C# 4.1.0 v3.1 latest (GA) 2023-07-31 DocumentAnalysisClient
.NET/C# 4.0.0 v3.0 (GA) 2022-08-31 DocumentAnalysisClient
.NET/C# 3.1.x v2.1 v2.1 FormRecognizerClient
.NET/C# 3.0.x v2.0 v2.0 FormRecognizerClient

Use Document Intelligence SDK in your applications

The Document Intelligence SDK enables the use and management of the Document Intelligence service in your application. The SDK builds on the underlying Document Intelligence REST API allowing you to easily use those APIs within your programming language paradigm. Here's how you use the Document Intelligence SDK for your preferred language:

1. Install the SDK client library

dotnet add package Azure.AI.FormRecognizer --version 4.1.0
Install-Package Azure.AI.FormRecognizer -Version 4.1.0

2. Import the SDK client library into your application

using Azure;
using Azure.AI.FormRecognizer.DocumentAnalysis;

3. Set up authentication

There are two supported methods for authentication

Use your API key

Here's where to find your Document Intelligence API key in the Azure portal:

Screenshot of the keys and endpoint location in the Azure portal.

//set `<your-endpoint>` and `<your-key>` variables with the values from the Azure portal to create your `AzureKeyCredential` and `DocumentAnalysisClient` instance
string key = "<your-key>";
string endpoint = "<your-endpoint>";
AzureKeyCredential credential = new AzureKeyCredential(key);
DocumentAnalysisClient client = new DocumentAnalysisClient(new Uri(endpoint), credential);

Use an Azure Active Directory (Azure AD) token credential


Regional endpoints do not support AAD authentication. Create a custom subdomain for your resource in order to use this type of authentication.

Authorization is easiest using the DefaultAzureCredential. It provides a default token credential, based upon the running environment, capable of handling most Azure authentication scenarios.

Here's how to acquire and use the DefaultAzureCredential for .NET applications:

  1. Install the Azure Identity library for .NET:

        dotnet add package Azure.Identity
        Install-Package Azure.Identity
  2. Register an Azure AD application and create a new service principal.

  3. Grant access to Document Intelligence by assigning the Cognitive Services User role to your service principal.

  4. Set the values of the client ID, tenant ID, and client secret in the Azure AD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID, and AZURE_CLIENT_SECRET, respectively.

  5. Create your DocumentAnalysisClient instance including the DefaultAzureCredential:

    string endpoint = "<your-endpoint>";
    var client = new DocumentAnalysisClient(new Uri(endpoint), new DefaultAzureCredential());

For more information, see Authenticate the client

4. Build your application

Create a client object to interact with the Document Intelligence SDK, and then call methods on that client object to interact with the service. The SDKs provide both synchronous and asynchronous methods. For more insight, try a quickstart in a language of your choice.

Help options

The Microsoft Q&A and Stack Overflow forums are available for the developer community to ask and answer questions about Azure AI Document Intelligence and other services. Microsoft monitors the forums and replies to questions that the community has yet to answer. To make sure that we see your question, tag it with azure-form-recognizer.

Next steps