Document Processing. Tariff Intelligence. Shipment Management.

Programmatically access document processing, tariff intelligence, and shipment management 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

POST /api/v1/external/oauth/token

// Request
curl -X POST https://api.wove.com/api/v1/external/oauth/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET"

// Response
{
  "access_token": "eyJhbGciOiJSUzI1NiIs...",
  "token_type": "Bearer",
  "expires_in": 3600
}

Who are you building for?

Automate the document workflow. Ship faster, validate everything.

Wove's API handles the document-heavy work that slows down freight operations — extracting structured data from commercial invoices, bills of lading, and packing lists, validating it across documents, and pushing status updates to your system in real time via webhooks. Integrate once and eliminate manual data entry across your entire shipment workflow.

Document Extraction & Validation

AI extracts structured data from any shipping document — invoices, BOLs, packing lists — and cross-validates values across sources with confidence scoring.

Shipment Creation & Management

Programmatically create, update, and manage shipment records with full container, package, and reference number support.

Real-Time Webhooks

Get notified the moment extraction completes or validation status changes. HMAC-SHA256 signed payloads for secure, reliable event handling.

Email Automation

Trigger document processing and shipment updates directly from inbound email workflows. No manual handoff required.

See it in action: Document validation response

GET /api/v1/external/shipments/shp_abc123/details

// 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"
}

Endpoint highlights

POST/documents— upload and trigger extraction

GET/shipments/{id}/details— full validated shipment record

POST/webhooks— register event listeners

GET/shipments/{id}/validation-items— cross-document validation

Ready to Integrate?

Start with our API documentation or talk to a solutions engineer about your specific use case.

Trusted by the most innovative names in global trade