​

Welcome to the Oktavius ERP API

​

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

​

Authentication

Authorization: Bearer okt_live_your_token_here

• Tokens start with okt_live_ (production) or okt_test_ (testing)
• 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)

​

Quick Example

curl -X GET "https://api.oktavius.ai/v1/openapi/extractions?auftragsnummer=22201161" \
  -H "Authorization: Bearer okt_live_your_token_here"

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)`);

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)")

​

Support