Document Processing. Shipment Management. Validation.
Programmatically access document processing, shipment management, and validation capabilities with OAuth 2.0 authentication and real-time webhooks.
Getting Started
Four simple steps to integrate with Wove API
Create OAuth Client
Contact your account manager to create OAuth credentials
Get Access Token
Use client credentials flow to obtain bearer token
Make API Calls
Include bearer token in Authorization header
Handle Rate Limits
Monitor rate limit headers in responses
// Complete shipment details with extracted document data
{
"id": "shp_abc123",
"shipmentNumber": "WOV240001",
"status": "validated",
"mode": "ocean",
"direction": "import",
"origin": {
"type": "port",
"code": "USLAX",
"name": "Los Angeles",
"country": "US"
},
"destination": {
"type": "port",
"code": "CNSHA",
"name": "Shanghai",
"country": "CN"
},
"referenceNumbers": [
{
"type": "booking_number",
"value": "BOOK123456",
"source": "extracted"
}
],
"containers": [
{
"id": "cnt_456",
"number": "MSKU1234567",
"type": "40HC",
"weight": 28500,
"weightUnit": "kg",
"sealNumbers": ["SEAL123"]
}
],
"documents": [
{
"id": "doc_789",
"type": "commercial_invoice",
"filename": "invoice.pdf",
"extractionStatus": "completed",
"validationStatus": "passed"
}
],
"validationItems": [
{
"id": "val_101",
"type": "container_weight",
"status": "validated",
"confidence": 0.95,
"extractedValue": "28,500 kg",
"sources": ["commercial_invoice", "packing_list"]
}
],
"createdAt": "2024-01-15T10:30:00Z",
"updatedAt": "2024-01-15T14:45:00Z"
}Key Features
Enterprise-grade API with comprehensive security and monitoring
OAuth 2.0 Authentication
Secure client credentials flow with configurable per-client rate limits
Real-Time Webhooks
Get notified of document processing events with HMAC-SHA256 signature verification
Document Processing
Upload, validate, and merge shipping documents with AI-powered extraction
Shipment Management
Create and manage shipment records with validation and merge operations
Rate Limiting
Configurable per-client rate limits with detailed headers for monitoring usage
Comprehensive Error Handling
Detailed error responses with troubleshooting information and consistent format
API Endpoints
Comprehensive API coverage for shipments, documents, and validation
Authentication
OAuth 2.0 token management and security
- • Get OAuth access token
- • Revoke OAuth token
- • Client credentials flow
Shipments
Complete shipment lifecycle management
- • Create, update, delete shipments
- • Manage containers and packages
- • Track events and validation items
Documents
Document processing and extraction
- • Upload and manage documents
- • AI-powered data extraction
- • Cross-validation and merging
Testing
API validation and monitoring tools
- • Test API connectivity
- • Check rate limit status
- • Monitor API usage statistics
Webhooks
Real-time event notifications
- • Extraction completed events
- • Validation status updates
- • HMAC-SHA256 signature verification
Rate Limiting
Configurable usage controls
- • 60 requests/minute default
- • 10,000 requests/day default
- • Per-client configuration available
Ready to Integrate?
Get started with our comprehensive API documentation and developer resources.
+ moreTrusted by the most innovative names in logistics