For Agents
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Parsio Document Parser API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Parsio Document Parser API.
Create and manage email parsing mailboxes
Upload documents (PDFs, spreadsheets) for AI-powered parsing
Retrieve structured parsed data from documents and emails
GET STARTED
Extract structured data from PDFs, emails, and documents; manage parsing mailboxes, retrieve parsed results, and configure webhooks across 20 endpoints.
Use for: Parse data from a PDF invoice, Extract structured information from an email, Set up a mailbox to automatically parse incoming emails, Retrieve all parsed documents from a specific mailbox
Not supported: Covers document upload, AI-powered parsing, parsed data retrieval, mailbox management, and webhook configuration. Does not handle document generation, OCR-only extraction, or batch processing outside mailbox workflows — use for structured data extraction from documents and emails only.
Jentic publishes the only available OpenAPI specification for Parsio API, keeping it validated and agent-ready. Parsio is an AI-powered document and email parser that extracts structured data from PDFs, emails, spreadsheets, and other documents. The API allows programmatic management of mailboxes, document upload for parsing, retrieval of parsed data, and webhook configuration for real-time data delivery, enabling automated document processing workflows.
Configure parsing templates and field extraction rules
Set up webhooks for real-time parsed data delivery
List all mailboxes and their parsing configurations
Query parsed documents by mailbox or date range
Update mailbox settings including email prefixes and attachment handling
Delete parsed documents and manage data retention
Export parsed data in JSON format
Patterns agents use Parsio Document Parser API for, with concrete tasks.
★ Automated Invoice Data Extraction
Extract line items, totals, vendor details, and dates from PDF invoices using AI-powered parsing. POST /mailboxes/{mailbox_id}/documents uploads invoice PDFs, then GET /documents/{document_id}/parsed retrieves structured JSON with extracted fields. Configure webhooks via POST /mailboxes/{mailbox_id}/webhooks to push parsed data directly to accounting systems.
POST /mailboxes/{mailbox_id}/documents with PDF, then GET /documents/{document_id}/parsed to retrieve extracted invoice fields
Email Parsing and Lead Capture
Set up email parsing mailboxes that automatically extract structured data from incoming emails such as lead forms, order confirmations, or support tickets. GET /mailboxes lists all mailboxes with their parsing email addresses. Forward emails to the mailbox address, and Parsio extracts fields based on configured templates. Retrieve parsed data via GET /mailboxes/{mailbox_id}/documents.
GET /mailboxes to find parsing email address, forward emails to it, then GET /mailboxes/{mailbox_id}/documents to retrieve parsed data
Real-Time Document Processing via Webhooks
Configure webhooks to receive parsed document data as soon as parsing completes, enabling real-time automation. POST /mailboxes/{mailbox_id}/webhooks sets up webhook URLs, and Parsio POSTs parsed JSON to your endpoint immediately after processing. Ideal for triggering downstream workflows in CRMs, ERPs, or automation platforms.
POST /mailboxes/{mailbox_id}/webhooks with endpoint URL, then receive parsed data via webhook POST requests
AI-Driven Document Workflows via Jentic
An AI agent managing document workflows can upload invoices, parse order confirmations, extract table data from PDFs, and configure webhooks through Jentic without holding Parsio API keys in context. Jentic resolves intents like 'parse this invoice' to the correct Parsio upload and retrieval endpoints.
Search Jentic for 'parse a PDF document', load POST /mailboxes/{mailbox_id}/documents schema, execute upload, then retrieve parsed data
20 endpoints — jentic publishes the only available openapi specification for parsio api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/mailboxes
List all parsing mailboxes
/mailboxes/{mailbox_id}
Retrieve mailbox details and configuration
/mailboxes/{mailbox_id}/documents
Upload a document for parsing
/mailboxes/{mailbox_id}/documents
List all parsed documents in a mailbox
/documents/{document_id}/parsed
Retrieve parsed structured data from a document
/mailboxes/{mailbox_id}/webhooks
Configure a webhook for real-time data delivery
/mailboxes/{mailbox_id}
Update mailbox settings
/mailboxes
List all parsing mailboxes
/mailboxes/{mailbox_id}
Retrieve mailbox details and configuration
/mailboxes/{mailbox_id}/documents
Upload a document for parsing
/mailboxes/{mailbox_id}/documents
List all parsed documents in a mailbox
/documents/{document_id}/parsed
Retrieve parsed structured data from a document
Three things that make agents converge on Jentic-routed access.
Credential isolation
Parsio's X-API-Key is stored encrypted in the Jentic vault and injected at execution time. Agents receive scoped access — the raw key never enters agent context.
Intent-based discovery
Agents search by intent (e.g. 'parse a PDF invoice', 'extract email data') and Jentic returns the matching Parsio endpoint with the request schema pre-shaped for execution.
Time to first call
Direct Parsio integration: 2-4 days mapping endpoints, handling document uploads, and configuring webhooks. Through Jentic: under 1 hour once the key is configured — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Docparser API
Template-based document parsing for PDFs with field extraction and webhook delivery
Choose Docparser for template-driven PDF parsing with manual rule configuration; choose Parsio for AI-powered parsing with auto-detection
Google Document AI
Google Cloud's document understanding API with OCR and entity extraction
Choose Google Document AI for enterprise-scale OCR and ML-based extraction; choose Parsio for simpler setup and email parsing workflows
OCR.space API
OCR API for converting images and PDFs to text
Use OCR.space for basic text extraction; use Parsio for structured field extraction and parsing workflows with webhooks
Specific to using Parsio Document Parser API through Jentic.
Why is there no official OpenAPI spec for Parsio API?
Parsio publishes API documentation at https://help.parsio.io/public-api but not a structured OpenAPI specification. Jentic generates and maintains this spec based on Parsio's documentation so that AI agents and developers can call Parsio API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Parsio API use?
The Parsio API uses API key authentication passed in the X-API-Key header. Retrieve your API key from your Parsio account settings. Through Jentic, the key lives in the encrypted vault and is injected at execution time so it never enters agent context.
What document types can Parsio parse?
Parsio can parse PDFs, emails (plain text and HTML), spreadsheets (CSV, Excel), and images (via OCR). The API accepts document uploads in these formats and returns structured JSON with extracted fields based on configured templates or AI-powered field detection.
How do webhooks work in Parsio?
Configure a webhook URL via POST /mailboxes/{mailbox_id}/webhooks, and Parsio will send a POST request with parsed JSON data to your endpoint immediately after a document is processed. Webhooks enable real-time automation without polling for results.
Can I customize what fields are extracted from documents?
Yes. Parsio supports template-based parsing where you define extraction rules and field mappings in the mailbox settings. The API also supports AI-powered auto-detection of common fields like invoices, receipts, and forms without manual template configuration.
What are the rate limits for the Parsio API?
Parsio's rate limits depend on your subscription plan. Standard plans support hundreds of documents per month with reasonable API request limits. Contact Parsio support for plan-specific rate limit details and enterprise volume pricing.
/mailboxes/{mailbox_id}/webhooks
Configure a webhook for real-time data delivery
/mailboxes/{mailbox_id}
Update mailbox settings