Upload Mapped Invoice Document

​

Overview

• debt_id: stable encrypted debt ID from the Debts API
• invoice_reference: invoice reference stored on the debt
• internal_id: your internal debt ID

​

Authentication

​

Example Request

curl -X POST "/external-api/v1/invoice-documents" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "invoice=@./invoice.pdf;type=application/pdf" \
  -F "invoice_reference=INV-2026-001"

​

Success Response

{
  "error": false,
  "message": "Invoice document uploaded successfully",
  "data": {
    "id": "document_encrypted_id",
    "debt_id": "debt_encrypted_id",
    "internal_id": "DEBT-2026-001",
    "invoice_reference": "INV-2026-001",
    "original_filename": "invoice.pdf",
    "status": "active",
    "match_method": "manual",
    "created_at": "2026-07-04T10:30:00+00:00"
  }
}

​

Errors

• 400 - Missing file, invalid upload, non-PDF file, or file too large
• 403 - Missing scope or invoice documents feature is not enabled
• 404 - No matching accessible debt was found
• 409 - The debt already has an invoice document and replace_manual was not set