Status Lifecycle

Understanding the lifecycle of a receipt generation job.

pending

Job accepted & queued

processing

Blockchain data fetching & PDF generation

completed

Asset ready for download

failed

Generation stopped

States Detail

pendingPending
The job has been accepted by the API and is waiting in the queue. Typically lasts for a few milliseconds to seconds depending on load.
processingProcessing
A worker has picked up the job. It is currently fetching transaction data from the blockchain (RPC calls), resolving metadata (ENS, Token names), and rendering the PDF. This usually takes 2-10 seconds.
completedCompleted
The receipt has been successfully generated. The response will contain the `pdfUrl` and structured `bill` data. This is a terminal state.
failedFailed
Generation failed. Check the `error` description in the response. Common causes include invalid transaction hashes, unsupported chains, or RPC failures. This is a terminal state.