# DocuClipper API (machine hints)

Base URL (prod): https://www.docuclipper.com/api/v1
Base URL (local): http://localhost:8080/api/v1
Auth: Authorization: Bearer <API_KEY>

OpenAPI:
- /openapi.json
- /.well-known/openapi.json

Core workflow:
1) POST /protected/document (multipart form field: document)
2) POST /protected/job (bank: enableBankMode=true; invoice: jobType=Invoice; tax form: jobType=Form)
3) GET /protected/job/<id> until status == Succeeded (prefer webhooks over polling)
4) POST /protected/job/<id>/export with format=json
  - bank statements/check images: jobType=FieldsToExcel1
  - invoices: jobType=Invoice
  - tax forms: jobType=Form (returns documentId -> array of {rowNumber,pageNumber,form{label:value}})

Fraud:
- GET /protected/document/<documentId>/fraudSignals

Human docs:
- /docs/getting-started/
- /docs/bank-statement-ocr-api/
- /docs/bank-statement-fraud-detection-api/
- /docs/check-ocr-api/
- /docs/invoice-ocr-api/
- /docs/tax-form-ocr-api/
- /docs/file-uploads/
- /docs/webhooks/