Report Statuses

Every report in LightLead goes through a defined lifecycle, reflected by its status.

Lifecycle

draft → pending → running → completed
                              → partial
                              → failed
                              → cancelled

All statuses

Status	Display	Description
draft	Draft	The report has been created but never run
pending	Pending	The report is queued for execution
running	Running	Data is being requested from the sources
completed	Completed	All data was successfully retrieved and processed
partial	Partial	Some sources returned an error, some succeeded
failed	Failed	No source returned data
cancelled	Cancelled	Execution was cancelled by the user or the system

Detailed description

draft

The initial status. The report has been created and configured, but hasn't been run yet.

• Possible actions: run, edit, delete
• Shown in the UI as "Draft" in gray

pending

The report has been submitted for execution and is in the queue. Wait time depends on:

• System load

• The number of sources in the report

• The plan (queue priority)

• Possible actions: cancel

• In the UI: "Pending" in yellow

running

Data is being requested from the sources' APIs. Duration depends on:

• The number of sources

• The volume of data requested

• The source API's speed

• Rate limiting constraints

• Possible actions: cancel

• In the UI: "Running" in blue with a progress indicator

completed

All data was successfully retrieved, normalized, and saved. The report is ready to view.

• Possible actions: view, export, copy, rerun
• In the UI: "Completed" in green

partial

Some sources succeeded, some failed. Data is available, but incomplete.

Causes:

• One of the sources is unavailable

• One of the connections' tokens expired

• A temporary API error at one of the sources

• Possible actions: view available data, rerun, diagnose errors

• In the UI: "Partial" in orange, listing the problematic sources

failed

Execution finished with an error. No data was retrieved from any source.

Causes:

• All sources are unavailable

• All tokens expired

• A report configuration error

• A system error

• Possible actions: diagnose, rerun after fixing

• In the UI: "Failed" in red with an error message

cancelled

Execution was interrupted.

Causes:

• The user clicked "Cancel"

• The system cancelled it due to timeout

• An administrator stopped execution

• Data isn't saved

• Possible actions: rerun

• In the UI: "Cancelled" in gray

Timeouts

The system automatically cancels a report when it exceeds the time limit:

Plan	Timeout
Free	5 minutes
Solo	15 minutes
Agency+	30 minutes

Retries

On a failed status, the system automatically makes up to 3 retries with exponential backoff before finally moving to failed.

Related pages

• Connection Statuses
• Error Codes
• Schedules