# Docutray

> Docutray is a document processing platform that converts any document
> into structured data using AI-powered OCR, with validation workflows
> and a multi-tenant REST API.















This guide will help you get started with DocuTray quickly.

## Creating an Account [#creating-an-account]

To start using DocuTray, you need to create an account by following these steps:

1. Visit the registration page at [https://app.docutray.com/register](https://app.docutray.com/register)

<img alt="DocuTray Registration Page" src="__img0" />

2. Complete the required fields:
   * **Full Name**: Enter your first and last name
   * **Email**: Use a valid email address
   * **Password**: Create a secure password (minimum 8 characters)
   * **Confirm Password**: Repeat the password for verification

<img alt="Completed Registration Form" src="__img1" />

3. Click the "Register" button

4. You will receive a confirmation email at the provided address. Open this email and click the verification link.

<img alt="Verification Email" src="__img2" />

5. Done! Once your account is verified, you can log in and start using DocuTray.

If you already have an account, you can go directly to the [login page](https://app.docutray.com/login).

## Creating an API Key [#creating-an-api-key]

After creating your account, you can generate an API Key to integrate DocuTray with your applications by following these steps:

1. Log in to your DocuTray account at [https://app.docutray.com/login](https://app.docutray.com/login)

2. Select the organization you want to work with

3. Navigate to "Account" > "API Keys" in the navigation menu

<img alt="API Keys Menu" src="__img3" />

4. Click the "New API Key" button

5. Enter a descriptive name for your API Key and click "Create"

<img alt="Create New API Key" src="__img4" />

6. Copy the generated API Key and store it in a safe place. **Important**: This will be the only time you can see the complete key.

<img alt="Copy API Key" src="__img5" />

You can now use this API Key to authenticate your requests to the DocuTray API.

## Your First Conversion [#your-first-conversion]

Once you have your API Key, you can process your first document with a simple API call.

### Supported File Formats [#supported-file-formats]

DocuTray supports the following file formats:

* **Images**: JPEG, PNG, GIF, BMP, WebP
* **Documents**: PDF (up to 100MB)

### Install the SDK [#install-the-sdk]

<Tabs groupId="lang" items="['Python', 'Node.js', 'cURL']">
  <Tab value="Python">
    ```bash
    pip install docutray
    ```
  </Tab>

  <Tab value="Node.js">
    ```bash
    npm install docutray
    ```
  </Tab>

  <Tab value="cURL">
    No installation required — cURL is available on most systems.
  </Tab>
</Tabs>

### Making the API Call [#making-the-api-call]

<Tabs groupId="lang" items="['Python', 'Node.js', 'cURL']">
  <Tab value="Python">
    ```python
    from pathlib import Path
    from docutray import Client

    client = Client(api_key="YOUR_API_KEY")

    result = client.convert.run(
        file=Path("invoice.pdf"),
        document_type_code="invoice"
    )

    print(result.data)
    ```
  </Tab>

  <Tab value="Node.js">
    ```typescript
    import DocuTray from 'docutray';
    import { readFileSync } from 'fs';

    const client = new DocuTray({ apiKey: 'YOUR_API_KEY' });

    const result = await client.convert.run({
      file: readFileSync('invoice.pdf'),
      documentTypeCode: 'invoice',
    });

    console.log(result.data);
    ```
  </Tab>

  <Tab value="cURL">
    ```bash
    curl -X POST https://app.docutray.com/api/convert \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -F "image=@invoice.pdf" \
      -F "document_type_code=invoice"
    ```
  </Tab>
</Tabs>

### Response [#response]

The API returns extracted data in JSON format according to your document type schema:

<Tabs groupId="lang" items="['Python', 'Node.js', 'cURL']">
  <Tab value="Python">
    ```python
    # result.data contains the extracted fields
    {
        "numero_factura": "F-2024-001",
        "fecha_emision": "2024-01-15",
        "rfc_emisor": "XAXX010101000",
        "razon_social_emisor": "Empresa Ejemplo S.A. de C.V.",
        "subtotal": 1000,
        "iva": 160,
        "total": 1160
    }
    ```
  </Tab>

  <Tab value="Node.js">
    ```typescript
    // result.data contains the extracted fields
    {
      numero_factura: 'F-2024-001',
      fecha_emision: '2024-01-15',
      rfc_emisor: 'XAXX010101000',
      razon_social_emisor: 'Empresa Ejemplo S.A. de C.V.',
      subtotal: 1000,
      iva: 160,
      total: 1160
    }
    ```
  </Tab>

  <Tab value="cURL">
    ```json
    {
      "data": {
        "numero_factura": "F-2024-001",
        "fecha_emision": "2024-01-15",
        "rfc_emisor": "XAXX010101000",
        "razon_social_emisor": "Empresa Ejemplo S.A. de C.V.",
        "subtotal": 1000,
        "iva": 160,
        "total": 1160
      }
    }
    ```
  </Tab>
</Tabs>

> **Tip**: For large files or batch processing, use async conversion which processes documents in the background:

<Tabs groupId="lang" items="['Python', 'Node.js', 'cURL']">
  <Tab value="Python">
    ```python
    status = client.convert.run_async(
        file=Path("large_document.pdf"),
        document_type_code="invoice"
    )
    # Poll for completion
    final = status.wait()
    print(final.data)
    ```
  </Tab>

  <Tab value="Node.js">
    ```typescript
    const status = await client.convert.runAsync({
      file: readFileSync('large_document.pdf'),
      documentTypeCode: 'invoice',
    });
    // Poll for completion
    const final = await status.wait();
    console.log(final.data);
    ```
  </Tab>

  <Tab value="cURL">
    ```bash
    # Start async conversion
    curl -X POST https://app.docutray.com/api/convert-async \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -F "image=@large_document.pdf" \
      -F "document_type_code=invoice"

    # Check status with the returned conversion_id
    curl https://app.docutray.com/api/convert-async/CONVERSION_ID \
      -H "Authorization: Bearer YOUR_API_KEY"
    ```
  </Tab>
</Tabs>

## Next Steps [#next-steps]

Now that you've completed your first conversion, explore these resources:

* **[Document Types](/docs/document-types)** — Browse available document types and their schemas
* **[API Reference](/docs/api)** — Complete API documentation with all endpoints
* **[Python SDK](/docs/python-sdk)** — Python SDK reference and guides
* **[Node.js SDK](/docs/node-sdk)** — Node.js SDK reference and guides
* **[Webhooks](/docs/webhooks)** — Set up webhooks to receive conversion results automatically
* **[Guides](/docs/guides)** — Step-by-step tutorials for common use cases


## Operations

- [Operations](https://docs.docutray.com/docs/operations): Docutray operations reference — convert, identify, knowledge bases, and steps: the core document-processing building blocks with multi-language examples.





Operations are the core building blocks of DocuTray. Each operation provides a specific document processing capability that you can use via our SDKs or REST API.

All examples below include tabs for **Python**, **Node.js**, and **cURL** so you can quickly get started in your preferred language.

<Cards>
  <Card title="Convert Documents" description="Extract structured data from documents using AI-powered OCR. Supports sync and async modes with file upload, URL, and base64 input." href="/docs/operations/convert" />

  <Card title="Identify Documents" description="Automatically detect the document type from a set of candidates. Get confidence scores and use the identify-then-convert flow." href="/docs/operations/identify" />

  <Card title="Document Types" description="List and inspect available document types and their JSON schemas. Validate extracted data against schemas." href="/docs/operations/document-types" />

  <Card title="Steps" description="Execute predefined workflow steps to process documents through configurable pipelines." href="/docs/operations/steps" />

  <Card title="Knowledge Bases" description="Manage knowledge bases with semantic search, document storage, and embedding-powered retrieval." href="/docs/operations/knowledge-bases" />
</Cards>

## Common Patterns [#common-patterns]

All document-processing operations (Convert, Identify, Steps) share these features:

* **Sync and Async modes** — Convert and Identify support both sync and async modes; Steps are async-only. Use sync for small documents and real-time responses, and async for large files or batch processing.
* **Multiple input methods** — Upload files directly, provide a URL, or send base64-encoded content.
* **Polling with SDKs** — The Python and Node.js SDKs provide built-in polling helpers (`wait()`) for async operations.
* **Error handling** — Consistent error types across all operations with typed exceptions in both SDKs.

## SDK Reference [#sdk-reference]

For detailed class and method documentation, see the full SDK references:

* [Python SDK Reference](/docs/python-sdk)
* [Node.js SDK Reference](/docs/node-sdk)
* [REST API Reference](/docs/api)


## Document Types

- [Document Types](https://docs.docutray.com/docs/document-types): Reference for every DocuTray document type — API codes, JSON schemas, and extracted field structures for invoices, payroll, statements, and more.



A **document type** tells DocuTray what to extract from a document and how to
shape the result. Each type defines a JSON schema, a stable API code (the
`document_type_code` you pass to the [convert](/docs/operations/convert)
endpoint), and the extraction hints that guide the OCR pipeline. When you
convert a file against a type, you always get back the same structured fields —
no matter the layout of the underlying scan.

The built-in types below cover common Chilean and international business
documents, grouped by domain. Each page documents the type's API code, its
response structure, and the individual fields it returns. Need something that
isn't listed? You can define your own with the
[Create a document type](/docs/guides/crear-tipo-documento) guide, or validate
extracted data against any schema with the
[Document Types operations](/docs/operations/document-types).

## Financial Documents [#financial-documents]

<Cards>
  <Card title="8-Column Balance Sheet" href="/docs/document-types/balance_ocho_columnas" />

  <Card title="Current Account Statement" href="/docs/document-types/cartola_cc" />

  <Card title="Credit Card Statement" href="/docs/document-types/cartola_tc" />

  <Card title="Promissory Note" href="/docs/document-types/pagare" />

  <Card title="Transbank Voucher" href="/docs/document-types/voucher_transbank" />
</Cards>

## Tax Documents [#tax-documents]

<Cards>
  <Card title="Professional Fee Receipt" href="/docs/document-types/boleta_honorarios" />

  <Card title="Electronic Invoice" href="/docs/document-types/factura" />

  <Card title="Invoice" href="/docs/document-types/invoice" />

  <Card title="Purchase Order" href="/docs/document-types/oc" />
</Cards>

## Labor Documents [#labor-documents]

<Cards>
  <Card title="AFP Contributions Certificate" href="/docs/document-types/cotizaciones_afp" />

  <Card title="Curriculum Vitae" href="/docs/document-types/cv" />

  <Card title="Payroll" href="/docs/document-types/liquidacion_sueldo" />
</Cards>

## Medical Documents [#medical-documents]

<Cards>
  <Card title="Medical Prescription" href="/docs/document-types/receta_medica" />
</Cards>

## International Commerce Documents [#international-commerce-documents]

<Cards>
  <Card title="Bill of Lading" href="/docs/document-types/bl" />
</Cards>


## Webhooks

- [Webhooks](https://docs.docutray.com/docs/webhooks): Receive real-time Docutray notifications via webhooks — configure endpoints for conversion, identification, and step events with secure signed delivery.
- [Webhook Configuration](https://docs.docutray.com/docs/webhooks/configuracion): Configure and manage Docutray webhooks — register endpoints, choose events, and secure delivery so your app reacts to document processing in real time.
- [Security and Signature Verification](https://docs.docutray.com/docs/webhooks/seguridad): Secure Docutray webhooks — two signature-verification methods plus replay-attack protection to confirm each payload genuinely came from Docutray.



Webhooks allow you to receive real-time notifications about events that occur in your Docutray account. When you configure a webhook, Docutray will send an HTTP POST request to the URL you specify each time an event you've subscribed to occurs.

## Available Webhook Types [#available-webhook-types]

Docutray supports three types of webhooks, each designed for different use cases:

<Cards>
  <Card title="Conversion Webhooks" href="/docs/webhooks/conversion">
    Receive notifications during document processing when using a specific document type to extract structured data.
  </Card>

  <Card title="Identification Webhooks" href="/docs/webhooks/identificacion">
    Receive notifications during the automatic document type identification process.
  </Card>

  <Card title="Steps Webhooks" href="/docs/webhooks/steps">
    Receive notifications during the execution of individual steps in document processing workflows.
  </Card>
</Cards>

## Configuration Guides [#configuration-guides]

<Cards>
  <Card title="Initial Setup" href="/docs/webhooks/configuracion">
    Learn how to configure and manage webhooks in your Docutray account.
  </Card>

  <Card title="Security and Verification" href="/docs/webhooks/seguridad">
    Protect your endpoints with HMAC signature verification and replay attack prevention.
  </Card>

  <Card title="Implementation Examples" href="/docs/webhooks/ejemplos">
    Sample code in Node.js and Python to implement webhooks.
  </Card>
</Cards>

## Key Features [#key-features]

* **Real-time notifications**: Receive events immediately as they occur
* **Multiple events**: Subscribe to specific events based on your needs
* **Robust security**: HMAC signature verification with two methods available
* **Automatic retries**: Retry system with exponential backoff
* **Flexible management**: Enable, disable, or delete webhooks without affecting your integration

## Next Steps [#next-steps]

1. **[Configuration](/docs/webhooks/configuracion)**: Start by setting up your first webhook
2. **[Security](/docs/webhooks/seguridad)**: Implement signature verification on your endpoint
3. **Select your webhook type**: Choose between Conversion, Identification, or Steps based on your use case
4. **[Examples](/docs/webhooks/ejemplos)**: Review sample code for your preferred language


## Guides

- [User Guides](https://docs.docutray.com/docs/guides): Step-by-step guides for DocuTray — create custom document types with the AI wizard, configure webhooks, and process your first documents.
- [Create Document Type](https://docs.docutray.com/docs/guides/crear-tipo-documento): Step-by-step guide to create custom document types using the AI-powered creation wizard



These guides walk you through DocuTray's core workflows end to end. Each one is
task-oriented: start from a goal — "create a document type", "receive webhook
notifications" — and follow the steps to a working result. If you are new to the
platform, begin with [Getting Started](/docs/getting-started) to create an
account and generate your first API key, then come back here to dig into
specific features.

Looking for something more reference-like instead of a tutorial? See the
[REST API reference](/docs/api), the [Node.js](/docs/node-sdk) and
[Python](/docs/python-sdk) SDKs, or the [CLI](/docs/cli) for the full surface of
every operation.

## Document Management [#document-management]

Define what DocuTray should extract from your documents. A document type pairs a
JSON schema with extraction hints, so every conversion of that type returns the
same structured shape.

<Cards>
  <Card title="Create Document Type" href="/docs/guides/crear-tipo-documento" description="Use the AI wizard to turn a single sample document into a reusable type with schema, prompts, and validation." />
</Cards>

## Configuration [#configuration]

Connect DocuTray to the rest of your stack — authenticate your requests and get
notified the moment a document finishes processing.

<Cards>
  <Card title="Getting Started" href="/docs/getting-started" description="Create your account, generate an API key, and run your first OCR conversion." />

  <Card title="Configure Webhooks" href="/docs/webhooks/configuracion" description="Receive real-time notifications when conversions, identifications, and steps complete." />
</Cards>


## Node.js SDK

- [Node.js SDK](https://docs.docutray.com/docs/node-sdk): Official Node.js SDK for the DocuTray API — typed OCR conversion, document identification, data extraction, and knowledge bases for Node 20+.
- [Client](https://docs.docutray.com/docs/node-sdk/client): Configure the Docutray Node.js client — API key, base URL, timeouts, and retries — plus the typed methods for convert, identify, and knowledge-base calls.
- [Errors](https://docs.docutray.com/docs/node-sdk/errors): Error handling in the Docutray Node.js SDK — the DocuTrayError hierarchy, HTTP status codes, and response details for robust retry and recovery logic.



The official Node.js library for the [DocuTray API](https://docutray.com), providing access to document processing capabilities including OCR, document identification, data extraction, and knowledge bases.

## Installation [#installation]

```bash
npm install docutray
```

Requires Node.js 20+.

## Quick Start [#quick-start]

```typescript
import DocuTray from 'docutray';
import { readFileSync } from 'fs';

const client = new DocuTray({ apiKey: 'your-api-key' });

// Convert a document
const result = await client.convert.run({
  file: readFileSync('invoice.pdf'),
  documentTypeCode: 'invoice',
});

console.log(result.data);
```

### Async Conversion [#async-conversion]

For large documents, use async conversion with polling:

```typescript
const status = await client.convert.runAsync({
  file: readFileSync('large_document.pdf'),
  documentTypeCode: 'invoice',
});

// Poll for completion
const final = await status.wait();
if (final.isSuccess()) {
  console.log(final.data);
}
```

## Configuration [#configuration]

<CodeBlockTabs defaultValue="API Key">
  <CodeBlockTabsList>
    <CodeBlockTabsTrigger value="API Key">
      API Key
    </CodeBlockTabsTrigger>

    <CodeBlockTabsTrigger value="Timeout">
      Timeout
    </CodeBlockTabsTrigger>

    <CodeBlockTabsTrigger value="Retries">
      Retries
    </CodeBlockTabsTrigger>
  </CodeBlockTabsList>

  <CodeBlockTab value="API Key">
    ```typescript
    // Via constructor
    const client = new DocuTray({ apiKey: 'your-api-key' });

    // Via environment variable (DOCUTRAY_API_KEY)
    const client = new DocuTray();
    ```
  </CodeBlockTab>

  <CodeBlockTab value="Timeout">
    ```typescript
    const client = new DocuTray({
      apiKey: 'your-api-key',
      timeout: 30_000, // 30 seconds
    });
    ```
  </CodeBlockTab>

  <CodeBlockTab value="Retries">
    ```typescript
    // Default: 2 retries with exponential backoff
    const client = new DocuTray({ apiKey: 'your-api-key', maxRetries: 5 });
    ```
  </CodeBlockTab>
</CodeBlockTabs>

## Resources [#resources]

### Client [#client]

The main entry point for the SDK:

* [`DocuTray`](/docs/node-sdk/client) — Client class with resource properties

### API Resources [#api-resources]

* [Convert](/docs/node-sdk/resources/convert) — Document conversion and data extraction
* [Identify](/docs/node-sdk/resources/identify) — Automatic document type identification
* [DocumentTypes](/docs/node-sdk/resources/document-types) — Document type catalog and schema validation
* [Steps](/docs/node-sdk/resources/steps) — Workflow step execution
* [KnowledgeBases](/docs/node-sdk/resources/knowledge-bases) — Knowledge base management and semantic search

### Error Handling [#error-handling]

* [Error Hierarchy](/docs/node-sdk/errors) — Comprehensive error classes with status-specific exceptions

### Types [#types]

Response and model types:

* [Convert Types](/docs/node-sdk/types/convert)
* [Identify Types](/docs/node-sdk/types/identify)
* [Document Type Types](/docs/node-sdk/types/document-type)
* [Step Types](/docs/node-sdk/types/step)
* [Knowledge Base Types](/docs/node-sdk/types/knowledge-base)
* [Shared Types](/docs/node-sdk/types/shared)


## Python SDK

- [Python SDK](https://docs.docutray.com/docs/python-sdk): Official Python SDK for the DocuTray API — OCR conversion, document identification, data extraction, and knowledge bases for Python 3.10+.
- [Client](https://docs.docutray.com/docs/python-sdk/client): Synchronous and asynchronous Docutray Python clients — configuration, auth, and typed methods for convert, identify, and knowledge-base operations.
- [Exceptions](https://docs.docutray.com/docs/python-sdk/exceptions): Error handling in the Docutray Python SDK — the exception hierarchy, API error details, and patterns for catching and recovering from failed requests.



The official Python library for the [DocuTray API](https://docutray.com), providing access to document processing capabilities including OCR, document identification, data extraction, and knowledge bases.

## Installation [#installation]

```bash
pip install docutray
```

Requires Python 3.10+.

## Quick Start [#quick-start]

### Synchronous Usage [#synchronous-usage]

```python
from pathlib import Path
from docutray import Client

client = Client(api_key="your-api-key")

# Convert a document
result = client.convert.run(
    file=Path("invoice.pdf"),
    document_type_code="invoice"
)
print(result.data)

client.close()
```

### Asynchronous Usage [#asynchronous-usage]

```python
import asyncio
from pathlib import Path
from docutray import AsyncClient

async def main():
    async with AsyncClient(api_key="your-api-key") as client:
        result = await client.convert.run(
            file=Path("invoice.pdf"),
            document_type_code="invoice"
        )
        print(result.data)

asyncio.run(main())
```

## Configuration [#configuration]

<CodeBlockTabs defaultValue="API Key">
  <CodeBlockTabsList>
    <CodeBlockTabsTrigger value="API Key">
      API Key
    </CodeBlockTabsTrigger>

    <CodeBlockTabsTrigger value="Timeout">
      Timeout
    </CodeBlockTabsTrigger>

    <CodeBlockTabsTrigger value="Retries">
      Retries
    </CodeBlockTabsTrigger>
  </CodeBlockTabsList>

  <CodeBlockTab value="API Key">
    ```python
    # Via constructor
    client = Client(api_key="your-api-key")

    # Via environment variable (DOCUTRAY_API_KEY)
    client = Client()
    ```
  </CodeBlockTab>

  <CodeBlockTab value="Timeout">
    ```python
    import httpx

    client = Client(
        api_key="your-api-key",
        timeout=httpx.Timeout(connect=5.0, read=60.0, write=60.0, pool=10.0)
    )
    ```
  </CodeBlockTab>

  <CodeBlockTab value="Retries">
    ```python
    # Default: 2 retries with exponential backoff
    client = Client(api_key="your-api-key", max_retries=5)
    ```
  </CodeBlockTab>
</CodeBlockTabs>

## Resources [#resources]

### Client [#client]

The main entry points for the SDK:

* [`Client`](/docs/python-sdk/client#client) — Synchronous client
* [`AsyncClient`](/docs/python-sdk/client#asyncclient) — Asynchronous client

### API Resources [#api-resources]

* [Convert](/docs/python-sdk/resources/convert) — Document conversion and data extraction
* [Identify](/docs/python-sdk/resources/identify) — Automatic document type identification
* [DocumentTypes](/docs/python-sdk/resources/document_types) — Document type catalog and schema validation
* [Steps](/docs/python-sdk/resources/steps) — Workflow step execution
* [KnowledgeBases](/docs/python-sdk/resources/knowledge_bases) — Knowledge base management and semantic search

### Error Handling [#error-handling]

* [Exception Hierarchy](/docs/python-sdk/exceptions) — Comprehensive error classes with status-specific exceptions

### Types [#types]

Response and model types:

* [Convert Types](/docs/python-sdk/types/convert)
* [Identify Types](/docs/python-sdk/types/identify)
* [Document Type Types](/docs/python-sdk/types/document_type)
* [Step Types](/docs/python-sdk/types/step)
* [Knowledge Base Types](/docs/python-sdk/types/knowledge_base)
* [Shared Types](/docs/python-sdk/types/shared)


## Optional

- [Electronic Invoice](https://docs.docutray.com/docs/document-types/factura): Extract Chilean SII electronic invoices with Docutray OCR — issuer, recipient, and line items. JSON schema, field structure, and API code (factura).
- [Invoice](https://docs.docutray.com/docs/document-types/invoice): Invoice document type reference for DocuTray — JSON schema, extracted field definitions, API code, and OCR extraction notes.
- [Professional Fee Receipt](https://docs.docutray.com/docs/document-types/boleta_honorarios): Extract Chilean boletas de honorarios with Docutray OCR — services, client, and tax fields. JSON schema, field structure, and API code (boleta_honorarios).
- [Payroll](https://docs.docutray.com/docs/document-types/liquidacion_sueldo): Extract payslips with Docutray OCR — salary, deductions, bonuses, and net pay. JSON schema, field-by-field structure, and API code (liquidacion_sueldo).
- [AFP Contributions Certificate](https://docs.docutray.com/docs/document-types/cotizaciones_afp): Extract AFP pension-contribution certificates with Docutray OCR — contribution history and employer data. JSON schema and API code (cotizaciones_afp).
- [Current Account Statement](https://docs.docutray.com/docs/document-types/cartola_cc): Extract bank current-account statements with Docutray OCR — balances and transaction lines. JSON schema, fields, and API code (cartola_cc).
- [Credit Card Statement](https://docs.docutray.com/docs/document-types/cartola_tc): Extract credit card statements with Docutray OCR — credit limits, billed amounts, and transactions. JSON schema, field structure, and API code (cartola_tc).
- [8-Column Balance Sheet](https://docs.docutray.com/docs/document-types/balance_ocho_columnas): Extract 8-column balance sheets with Docutray OCR — company, period, and per-account values. JSON schema, fields, and API code (balance_ocho_columnas).
- [Bill of Lading](https://docs.docutray.com/docs/document-types/bl): Extract maritime Bill of Lading data with Docutray OCR — shipment, ports, and cargo details. JSON schema, fields, and API code for the bl type.
- [Curriculum Vitae](https://docs.docutray.com/docs/document-types/cv): Extract résumé and CV data with Docutray OCR — profile, education, and work experience. JSON schema, field-by-field structure, and API code for the cv type.
- [Purchase Order](https://docs.docutray.com/docs/document-types/oc): Extract corporate purchase orders with Docutray OCR — supplier, line items, and delivery details. JSON schema, fields, and API code (oc type).
- [Promissory Note](https://docs.docutray.com/docs/document-types/pagare): Extract financial promissory notes with Docutray OCR — debtor, amount, payment terms, and maturity date. JSON schema, fields, and API code (pagare).
- [Medical Prescription](https://docs.docutray.com/docs/document-types/receta_medica): Extract medical prescriptions with Docutray OCR — prescriber, patient, and medications with dosage. JSON schema, fields, and API code (receta_medica).
- [Transbank Voucher](https://docs.docutray.com/docs/document-types/voucher_transbank): Extract Transbank payment vouchers with Docutray OCR — card, merchant, and transaction amounts. JSON schema, fields, and API code (voucher_transbank).
- [Conversion Events](https://docs.docutray.com/docs/webhooks/conversion): Docutray conversion webhooks — real-time callbacks fired while a document is processed, delivering the extracted structured data to your endpoint.
- [Identification Events](https://docs.docutray.com/docs/webhooks/identificacion): Docutray identification webhooks — real-time callbacks fired while a document's type is auto-detected, delivering the result to your endpoint.
- [Steps Events](https://docs.docutray.com/docs/webhooks/steps): Docutray step webhooks — real-time callbacks fired as individual workflow steps (conversion, identification, validation) execute in a pipeline.
- [Implementation Examples](https://docs.docutray.com/docs/webhooks/ejemplos): Complete implementation examples of webhooks in different languages and frameworks
- [Convert](https://docs.docutray.com/docs/node-sdk/resources/convert): Node.js SDK reference for the Convert resource — methods, parameters, and return types for the DocuTray API.
- [Identify](https://docs.docutray.com/docs/node-sdk/resources/identify): Node.js SDK reference for the Identify resource — methods, parameters, and return types for the DocuTray API.
- [Document Types](https://docs.docutray.com/docs/node-sdk/resources/document-types): Node.js SDK reference for the Document Types resource — methods, parameters, and return types for the DocuTray API.
- [Steps](https://docs.docutray.com/docs/node-sdk/resources/steps): Node.js SDK reference for the Steps resource — methods, parameters, and return types for the DocuTray API.
- [Knowledge Bases](https://docs.docutray.com/docs/node-sdk/resources/knowledge-bases): Node.js SDK reference for the Knowledge Bases resource — methods, parameters, and return types for the DocuTray API.
- [Convert Types](https://docs.docutray.com/docs/node-sdk/types/convert): Type definitions for Convert in the DocuTray Node.js SDK — request and response models, fields, and enums.
- [Identify Types](https://docs.docutray.com/docs/node-sdk/types/identify): Type definitions for Identify in the DocuTray Node.js SDK — request and response models, fields, and enums.
- [Document Type Types](https://docs.docutray.com/docs/node-sdk/types/document-type): Type definitions for Document Type in the DocuTray Node.js SDK — request and response models, fields, and enums.
- [Step Types](https://docs.docutray.com/docs/node-sdk/types/step): Type definitions for Step in the DocuTray Node.js SDK — request and response models, fields, and enums.
- [Knowledge Base Types](https://docs.docutray.com/docs/node-sdk/types/knowledge-base): TypeScript types for knowledge bases in the Docutray Node.js SDK — KnowledgeBase, documents, and semantic-search result models with fields and enums.
- [Shared Types](https://docs.docutray.com/docs/node-sdk/types/shared): Shared TypeScript types in the Docutray Node.js SDK — upload MIME types, pagination wrappers, rate-limit info, and error-detail models with fields.
- [Convert](https://docs.docutray.com/docs/python-sdk/resources/convert): Python SDK reference for the Convert resource — methods, parameters, and return types for the DocuTray API.
- [Identify](https://docs.docutray.com/docs/python-sdk/resources/identify): Python SDK reference for the Identify resource — methods, parameters, and return types for the DocuTray API.
- [Document Types](https://docs.docutray.com/docs/python-sdk/resources/document_types): Python SDK reference for the Document Types resource — methods, parameters, and return types for the DocuTray API.
- [Steps](https://docs.docutray.com/docs/python-sdk/resources/steps): Python SDK reference for the Steps resource — methods, parameters, and return types for the DocuTray API.
- [Knowledge Bases](https://docs.docutray.com/docs/python-sdk/resources/knowledge_bases): Python SDK reference for the Knowledge Bases resource — methods, parameters, and return types for the DocuTray API.
- [Convert Types](https://docs.docutray.com/docs/python-sdk/types/convert): Type definitions for Convert in the DocuTray Python SDK — request and response models, fields, and enums.
- [Identify Types](https://docs.docutray.com/docs/python-sdk/types/identify): Type definitions for Identify in the DocuTray Python SDK — request and response models, fields, and enums.
- [Document Type Types](https://docs.docutray.com/docs/python-sdk/types/document_type): Type definitions for Document Type in the DocuTray Python SDK — request and response models, fields, and enums.
- [Step Types](https://docs.docutray.com/docs/python-sdk/types/step): Type definitions for Step in the DocuTray Python SDK — request and response models, fields, and enums.
- [Knowledge Base Types](https://docs.docutray.com/docs/python-sdk/types/knowledge_base): Type definitions for Knowledge Base in the DocuTray Python SDK — request and response models, fields, and enums.
- [Shared Types](https://docs.docutray.com/docs/python-sdk/types/shared): Type definitions for Shared in the DocuTray Python SDK — request and response models, fields, and enums.
- [API Reference](https://docs.docutray.com/docs/api): Complete Docutray REST API reference — endpoints for document conversion, identification, document-type management, knowledge bases, and webhook automation.
- [convertDocument](https://docs.docutray.com/docs/api/conversion/convertDocument): Convert any document — invoice, receipt, contract, or scan — into structured JSON data using AI-powered OCR.
- [convertDocumentAsync](https://docs.docutray.com/docs/api/conversion/convertDocumentAsync): Process documents asynchronously and extract structured data using AI-powered OCR.
- [getConversionStatus](https://docs.docutray.com/docs/api/conversion/getConversionStatus): Poll the current status and retrieve the extracted result of an asynchronous document conversion by its ID.
- [createDocumentType](https://docs.docutray.com/docs/api/document-types/createDocumentType): Create a new document type with a JSON schema, extraction hints, and validation rules for the OCR pipeline.
- [getDocumentType](https://docs.docutray.com/docs/api/document-types/getDocumentType): Retrieve the full definition of a single document type by its ID, including its
- [listDocumentTypes](https://docs.docutray.com/docs/api/document-types/listDocumentTypes): Retrieve the paginated list of document types the user can access, with optional search by name, code, or description.
- [updateDocumentType](https://docs.docutray.com/docs/api/document-types/updateDocumentType): Update an existing document type's schema, name, description, prompt hints, or validation rules. All fields are optional.
- [validateDocument](https://docs.docutray.com/docs/api/document-types/validateDocument): Check whether a JSON document satisfies the rules of a document type **without
- [getIdentificationStatus](https://docs.docutray.com/docs/api/identification/getIdentificationStatus): Check the status and result of an identification started asynchronously
- [identifyDocument](https://docs.docutray.com/docs/api/identification/identifyDocument): Automatically identify the document type from a provided list of options.
- [identifyDocumentAsync](https://docs.docutray.com/docs/api/identification/identifyDocumentAsync): Identify the document type asynchronously from a provided list of options.
- [executeStepAsync](https://docs.docutray.com/docs/api/steps/executeStepAsync): Process documents using the specified Step configuration asynchronously.
- [getStepExecutionStatus](https://docs.docutray.com/docs/api/steps/getStepExecutionStatus): Retrieves the current status and results of a step execution with standardized response format.
- [getMonthlyUsage](https://docs.docutray.com/docs/api/usage/getMonthlyUsage): Returns how many pages and operations your organization has successfully