âš¡ Developer-First API
Same AI Power, Programmatic Access
Integrate Artificio's intelligent document processing and form management directly into your applications with our robust REST API.
- REST API with x-api-key authentication
- Document classification & data extraction
- Form submission & data collection
- Asynchronous processing with result polling
- Enterprise-grade security & reliability
- 99.9% uptime SLA with global infrastructure
Document API
Classify and extract from a document in four steps
Select the API that fits your use case. The document endpoints take a file and return structured data once processing completes.
- 1
Get Your API Token
Sign up for a free account and get your API token instantly. Use the x-api-key header for authentication.
- 2
Upload Your Document
Use the auto-classify endpoint to upload your document. We support PDF and common image formats for classification.
- 3
Get Classification Results
Retrieve the classification results using the result_id. Check the status and get extracted data when processing completes.
- 4
Integrate & Scale
Build the API into your applications for automated document classification and data extraction workflows.
curl -X POST https://api.artificio.ai/external/v2/auto-classify \
-H "x-api-key: YOUR_API_TOKEN" \
-F "file=@document.pdf"
API Reference
The document endpoints
Two calls: submit a file, then poll for the result with the id it returns.
- 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
Response- data
- result_id for tracking
- GET
/external/v2/auto-classify/results/{result_id}Retrieve the classification result once processing has completed.
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
Forms API
Integrate Forms into Your Applications
Submit data directly to forms created in Artificio App.
- 1
Create Form in Artificio App
Design your form using the Artificio App interface. Add fields, set validation rules, and get your form name.
- 2
Get Your API Token
Use the same x-api-key authentication as document processing. One token works for all APIs.
- 3
Submit Data via API
POST form data to your specific form endpoint. All submissions are automatically stored and accessible in the app.
Use Cases
Submit data to any form created in your Artificio App
# Replace FORM_NAME with your actual form name
# Replace YOUR_API_TOKEN with your API key
# Submit form data
import requests
response = requests.post(
"https://api.artificio.ai/external/forms/FORM_NAME",
headers={"x-api-key": "YOUR_API_TOKEN"},
data={
"firstName": "John",
"lastName": "Doe",
"email": "john@example.com",
"subject": "Contract Inquiry",
"notes": "Interested in BAA contract",
},
)
Get started
Ready to Get Started?
Join thousands of developers using Artificio's API. Get your API token and start building today.
Security & compliance
Enterprise security across every solution
ISO 27001:2013 certified, SOC 2 Type 2 compliant, GDPR and HIPAA ready. Every agent action is logged, auditable, and runs in isolated environments.
- ISO 27001:2013
- SOC 2 Type II
- GDPR ready
- HIPAA ready