Review Queue API

Programmatically interact with the CargoLint review queue to list, correct, and approve document extractions.

For dashboard-based review instructions, see How to Review Extracted Data.

Listing the Review Queue

curl -X GET "https://api.cargolint.com/api/v1/review?status=requires_review&page=1&pageSize=20" \
  -H "X-API-Key: YOUR_API_KEY"

Query parameters include status, documentType, sortBy (newest, oldest, confidence), and pagination.

Getting Review Details

curl -X GET https://api.cargolint.com/api/v1/review/{document_id} \
  -H "X-API-Key: YOUR_API_KEY"

Returns the document’s extracted fields with confidence scores and validation issues.

Submitting Corrections

curl -X POST https://api.cargolint.com/api/v1/review/{document_id}/corrections \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "corrections": [
      {
        "fieldName": "invoiceNumber",
        "correctedValue": "INV-2026-001234"
      }
    ]
  }'

Approving Without Changes

curl -X POST https://api.cargolint.com/api/v1/review/{document_id}/approve \
  -H "X-API-Key: YOUR_API_KEY"

Skipping a Document

curl -X POST https://api.cargolint.com/api/v1/review/{document_id}/skip \
  -H "X-API-Key: YOUR_API_KEY"

Review Threshold

Documents are routed to the review queue when overall confidence falls below 70% (0.70). Penalties that reduce confidence include missing required fields (-0.20), calculation mismatches (-0.20), and format warnings (-0.10).