โก 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
# 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-keyauthentication - 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
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
Get your API token
Sign up for a free account and get your token instantly. Authenticate with the
x-api-keyheader. - 2
Upload your document
POST to the
auto-classifyendpoint. PDF and common image formats are supported. - 3
Get results
Retrieve results with the
result_id. Check status and pull extracted data when ready. - 4
Integrate & scale
Build the API into your apps for automated classification and extraction workflows.
# 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"
import requests, time
BASE = "https://api.artificio.ai/external/v2/auto-classify"
headers = {"x-api-key": "YOUR_API_TOKEN"}
# 1) Upload
up = requests.post(BASE, headers=headers,
files={"file": open("invoice.pdf", "rb")}
result_id = up.json()["data"]
# 2) Poll until ready
while True:
res = requests.get(f"{BASE}/results/{result_id}", headers=headers)
data = res.json()["data"]
if data["status"] != "processing":
break
time.sleep(2)
print(data["result"])
import fs from "fs";
const BASE = "https://api.artificio.ai/external/v2/auto-classify";
const headers = { "x-api-key": "YOUR_API_TOKEN" };
1) Upload
const form = new FormData();
form.append("file", new Blob([fs.readFileSync("invoice.pdf")]));
const up = await fetch(BASE, { method: "POST", headers, body: form });
const { data: resultId } = await up.json();
2) Poll for the result
const res = await fetch(`${BASE}/results/${resultId}`, { headers });
console.log((await res.json()).data.result);
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-classifyUpload 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
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?
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?
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?
How fast is it, and how reliable?
How is my data handled?
What's the difference between the two APIs?
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.