Skip to main content

โšก Developer-First API

Same AI Power, Programmatic Access

Integrate Artificio's intelligent document processing and form management directly into your applications with a robust REST API. Upload a document, get it classified and extracted, and poll for results, with simple key-based auth and enterprise-grade reliability.

  • REST
  • x-api-key auth
  • Async + polling
  • 99.9% SLA
quickstart.py
# Upload a document for classification
import requests

url = "https://api.artificio.ai/external/v2/auto-classify"
headers = {"x-api-key": "YOUR_API_TOKEN"}
files = {"file": open("invoice.pdf", "rb")}

r = requests.post(url, headers=headers, files=files)
result_id = r.json()["data"]

# Poll for the extracted result
res = requests.get(
    f"{url}/results/{result_id}",
    headers=headers,
)
print(res.json()["data"]["result"])
  • Simple REST API with x-api-key authentication
  • Document classification & data extraction out of the box
  • Form submission & data collection endpoints
  • Asynchronous processing with result polling
  • Enterprise-grade security, and a 99.9% uptime SLA
99.9%Uptime SLA
<200msAvg response time
50M+Documents processed
500+Active developers

Get started in minutes

From API key to first successful request in under 5 minutes.

Four steps, no SDK required, plain HTTP with a single header.

  1. 1

    Get your API token

    Sign up for a free account and get your token instantly. Authenticate with the x-api-key header.

  2. 2

    Upload your document

    POST to the auto-classify endpoint. PDF and common image formats are supported.

  3. 3

    Get results

    Retrieve results with the result_id. Check status and pull extracted data when ready.

  4. 4

    Integrate & scale

    Build the API into your apps for automated classification and extraction workflows.

upload.sh
# Upload a document for classification
curl -X POST "https://api.artificio.ai/external/v2/auto-classify" \
  -H "x-api-key: YOUR_API_TOKEN" \
  -F "file=@invoice.pdf"

# Response: { "data": "<result_id>" }

# Poll for the extracted result
curl "https://api.artificio.ai/external/v2/auto-classify/results/<result_id>" \
  -H "x-api-key: YOUR_API_TOKEN"

Choose your integration

Two APIs, one platform.

Pick the surface that fits your use case, both share the same key-based auth and async model.

  • Document Processing API

    Classify & extract

    Upload a document and get automatic classification and structured data extraction back. Supports PDF, images, Word and Excel, and 20+ document types out of the box.uploadclassifyextractpoll result
  • Form Design API

    Submit & collect

    Drive form submission and data collection programmatically, feed captured data into your workflows without standing up your own intake layer.submitvalidatecollect

Powerful features

Everything you need to build document workflows.

  • โšก

    Lightning fast

    Process documents in under 200ms with globally distributed infrastructure and optimized AI models.
  • ๐ŸŽฏ

    Auto classification

    Automatically classify and extract data from documents using advanced AI models with high accuracy.
  • ๐Ÿ”’

    Enterprise security

    SOC 2 compliant with end-to-end encryption, GDPR compliance, and automatic data-deletion options.
  • ๐Ÿ”„

    Async processing

    Upload documents and retrieve results asynchronously via the result_id system for efficient throughput.
  • ๐Ÿ“Š

    Multiple formats

    PDF, images (JPG, PNG), Word docs, Excel files, and 20+ document types supported out of the box.
  • ๐ŸŒ

    Global CDN

    Low latency worldwide with edge locations in 50+ countries and automatic failover capabilities.

API reference

Endpoints for classification and extraction.

Every request authenticates with the x-api-key header. Uploads return a result_id you poll for the extracted data.

  • POST/external/v2/auto-classify

    Upload a document file for automatic classification and data extraction.

    Headers
    Content-Type
    multipart/form-data
    x-api-key
    YOUR_API_TOKEN
    Body
    file required
    document file (PDF, image, and more)
    Response
    data
    result_id for tracking
  • GET/external/v2/auto-classify/results/{result_id}

    Retrieve classification results using the result_id from the upload request.

    Headers
    Content-Type
    application/json
    x-api-key
    YOUR_API_TOKEN
    Parameters
    result_id required
    ID from upload
    Response
    data.status
    success / processing / error
    data.result
    extracted data object

Automating something that isn't on this page? The agents adapt to new document types, new systems and new rules. Tell us what you are automating and we will show you the nearest thing we run.

Talk to our team
Built for production

The same AI behind our platform, as an endpoint.

The API exposes the exact document intelligence that powers Artificio's platform and SAP integration: classification, extraction and validation, wrapped in enterprise security and a 99.9% uptime SLA. Build it into your apps, or let it feed your automation.

Why build on Artificio

Why developers choose the Artificio API.

  • Dead-simple authOne x-api-key header, no OAuth dance to ship a prototype.
  • Async by designUpload, get a result_id, poll, clean for high volume.
  • Fast responsesSub-200ms average on globally distributed infrastructure.
  • 20+ formatsPDF, images, Word and Excel handled out of the box.
  • Enterprise securitySOC 2, encryption, GDPR, and auto data-deletion.
  • 99.9% uptime SLAGlobal CDN with failover in 50+ countries.
  • Proven at scale50M+ documents processed, 500+ active developers.
  • Same AI as the platformThe extraction that posts into SAP, as an endpoint.

FAQ

Common questions.

How does authentication work?
Every request is authenticated with a single x-api-key header. Sign up for an account, generate a token, and include it on each call, no OAuth flow required to get started.
Is processing synchronous or asynchronous?
Asynchronous. You upload a document to the auto-classify endpoint and receive a result_id immediately, then poll the results endpoint until status is success. This keeps things efficient at high volume rather than holding a connection open.
What document formats are supported?
PDF, images such as JPG and PNG, Word documents, Excel files, and 20+ document types out of the box, with automatic classification across them.
How fast is it, and how reliable?
Average response time is under 200ms on globally distributed infrastructure, backed by a 99.9% uptime SLA and a global CDN with automatic failover across 50+ countries.
How is my data handled?
The API is SOC 2 compliant with end-to-end encryption and GDPR compliance, and offers automatic data-deletion options so documents don't persist longer than you need.
What's the difference between the two APIs?
The Document Processing API classifies and extracts data from uploaded documents; the Form Design API handles form submission and data collection. Both use the same key-based auth and integrate the same way.

Security & compliance

Enterprise security by design

The Artificio API is SOC 2 compliant with end-to-end encryption, GDPR compliance, and automatic data-deletion options, so documents don't persist longer than you need, backed by a 99.9% uptime SLA.

  • SOC 2
  • END-TO-END ENCRYPTION
  • GDPR
  • 99.9% SLA

Ready to get started?

Get your API token and start building today.

Join thousands of developers using Artificio's API. From key to first successful request in under five minutes.