> ## Documentation Index
> Fetch the complete documentation index at: https://docs.docintell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SDKs & Examples

> Code examples for integrating with DocIntell

DocIntell provides a REST API that can be accessed from any programming language. This section contains examples in popular languages.

## Quick Links

<CardGroup cols={2}>
  <Card title="Python" icon="python" href="/sdks/python">
    Python examples using requests
  </Card>

  <Card title="TypeScript" icon="js" href="/sdks/typescript">
    TypeScript/JavaScript examples
  </Card>

  <Card title="cURL" icon="terminal" href="/sdks/curl">
    Command-line examples
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    Full API documentation
  </Card>
</CardGroup>

## Common Patterns

### Authentication

All requests require an API key in the `Authorization` header:

```bash theme={null}
Authorization: Bearer dk_live_YOUR_API_KEY
```

### Async Processing

Document extraction is asynchronous. Here's the recommended flow using webhooks:

```mermaid theme={null}
sequenceDiagram
    participant App as Your App
    participant API as DocIntell API

    App->>API: POST /v1/documents (PDF)
    API->>App: 202 Accepted + job_id

    Note over API: Processing (5-90 seconds)

    API->>App: Webhook: completed
```

**Two options for tracking completion:**

| Method                     | Best For                                    |
| -------------------------- | ------------------------------------------- |
| **Webhooks** (recommended) | Production systems, real-time notifications |
| **Polling**                | Quick testing, simple scripts               |

### Error Handling

All errors return RFC 7807 format:

```json theme={null}
{
  "error": "error_code",
  "message": "Human-readable message"
}
```

## Rate Limits

| Operation          | Limit      |
| ------------------ | ---------- |
| Document Ingestion | 100/hour   |
| Job Status Checks  | 1,000/hour |