Async processing

Extraction runs asynchronously. Poll GET /api/v1/protected/job/:id for status or use webhooks to get notified when the job completes.

Job statuses

  • Pending – Queued
  • Processing – In progress
  • Succeeded – Ready for export
  • Failed – Check errorMessage

Recommendation

Use webhooks for production to avoid polling. Register a webhook URL and subscribe to events such as bank_statement.extraction.completed.