API Overview
This guide provides a high-level overview of all Nanonets APIs, organized by functionality. Each section includes a brief description and links to the detailed API documentation.
Workflow Management APIs
These APIs allow you to create, configure, and manage document processing workflows.
Core Workflow Operations
- List Workflows: Retrieve all workflows in your account
- Get Workflow by ID: Get detailed information about a specific workflow
- Get Available Workflow Types: List all available workflow types
- Create Workflow: Create a new workflow with specified type
Field and Table Management
- Set Fields and Table Headers: Configure fields and table headers for document extraction
- Update Field or Table Header: Modify existing field or table header configuration
- Delete Field or Table Header: Remove a field or table header from the workflow
Workflow Configuration
- Update Workflow Metadata: Modify workflow name and description
- Update Workflow Settings: Configure processing settings and behavior
Document Processing APIs
These APIs handle document upload, processing, and result retrieval.
Document Operations
- Upload Document for Processing: Upload documents for processing in a workflow
- List Documents: Retrieve a list of processed documents
- Get Document Data: Get processing results for a specific document
- Get Page Data: Get processing results for a specific page
- Delete Document: Remove a processed document
Common Use Cases
Creating and Configuring a Workflow
- Get available workflow types
- Create a new workflow
- Configure fields and tables
- Update workflow settings
Processing Documents
- Upload documents for processing
- Monitor processing status
- Retrieve processing results
- Access page-level data
Best Practices
Workflow Management
- Choose the appropriate workflow type for your use case
- Configure fields and tables carefully
- Use descriptive names and metadata
- Monitor workflow performance
Document Processing
- Use async processing for large documents
- Include relevant metadata
- Implement proper error handling
- Clean up processed documents
For detailed best practices, see the Best Practices Guide.
Error Handling
All APIs return standard HTTP status codes and detailed error messages. Common scenarios include:
- Authentication errors
- Invalid requests
- Resource not found
- Processing failures
For detailed error handling, see the Error Handling Guide.
Rate Limits and Quotas
- API requests are subject to rate limits
- Document processing has concurrent limits
- Storage has usage quotas
- Monitor your usage to avoid limits
For information about rate limits, see Rate Limits.