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

# Welcome

> Integrate your systems with Oktavius ERP

# Welcome to the Oktavius ERP API

Retrieve structured document extraction results from Oktavius ERP directly into your own systems — ERP, Materialwirtschaft, invoicing, or any other software.

## What You Can Do

* **Query extractions by Auftragsnummer** — find all extracted Regiescheine for a specific order
* **Retrieve line items** — get article numbers, quantities, prices, and descriptions
* **Poll for new results** — use the `since` parameter to check for extractions completed after your last sync

## How It Works

```mermaid theme={null}
sequenceDiagram
    participant YourSystem as Your System
    participant API as Oktavius API
    participant DB as Extraction Database

    YourSystem->>API: GET /v1/openapi/extractions?auftragsnummer=22201161
    API->>DB: Query by Auftragsnummer
    DB-->>API: Matching extraction jobs
    API-->>YourSystem: JSON with positions, amounts, totals
```

## Authentication

All API requests require a Bearer token in the `Authorization` header:

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

**Token details:**

* Tokens start with `okt_live_`
* Default rate limit: **1,000 requests per hour**
* Tokens are scoped to your organization — you only see your own data
* Tokens expire after 90 days (renewable)

<Note>
  To request an API token, contact your Oktavius administrator or email [info@texterous.com](mailto:info@texterous.com).
</Note>

## Quick Example

<Tabs>
  <Tab title="cURL">
    ```bash theme={null}
    curl -X GET "https://api.oktavius.ai/v1/openapi/extractions?auftragsnummer=22201161" \
      -H "Authorization: Bearer okt_live_your_token_here"
    ```
  </Tab>

  <Tab title="JavaScript">
    ```javascript theme={null}
    const response = await fetch(
      "https://api.oktavius.ai/v1/openapi/extractions?auftragsnummer=22201161",
      { headers: { Authorization: "Bearer okt_live_your_token_here" } }
    );
    const { data, pagination } = await response.json();
    console.log(`Found ${pagination.total} extraction(s)`);
    ```
  </Tab>

  <Tab title="Python">
    ```python theme={null}
    import requests

    response = requests.get(
        "https://api.oktavius.ai/v1/openapi/extractions",
        params={"auftragsnummer": "22201161"},
        headers={"Authorization": "Bearer okt_live_your_token_here"},
    )
    data = response.json()
    print(f"Found {data['pagination']['total']} extraction(s)")
    ```
  </Tab>
</Tabs>

## Support

Questions or issues? Email [info@texterous.com](mailto:info@texterous.com).