Skip to main content

List Report Tasks

GET 
/api/veracore/integration-instances/:integration_instance/report-tasks

List Veracore report tasks for an integration instance. A report task represents one Veracore report run used to import shipment and tracking data for a date range. Tasks are returned newest first.

Authorization

Any valid API token can call this endpoint — no specific scope required. Manage tokens.

Statuses

  • created — task created, not yet submitted for polling.
  • polling — waiting for Veracore to finish generating the report (poll_attempts counts checks so far).
  • done — report retrieved, awaiting processing.
  • processed — report rows applied (rows_matched reports how many rows matched local records).
  • failed — the run failed (error_message explains why); it can be retried.
  • superseded — replaced by a retry and no longer polled.

Filters

  • filter[status] — exact status value from the list above.
  • filter[date_from] / filter[date_to] — created date range (inclusive, whole days).
  • Operator-suffixed filters are also available: filter[created_at.<op>] and filter[processed_at.<op>] with date operators (is, is_not, before, after, on_or_before, on_or_after, between, is_empty, is_not_empty, today, yesterday, past_week, past_month, past_year, days_ago, past_days, and more), and filter[report_name.<op>] with text operators (contains, does_not_contain, is, is_not, is_one_of, is_not_one_of, starts_with, ends_with, is_empty, is_not_empty, and more).
  • filter_groups — a base64-encoded JSON tree combining the operator-suffixed filters with nested and/or groups.

Sorting sort accepts id, status, report_name, created_at, processed_at, poll_attempts, rows_matched (prefix with - for descending). Default sort is -id.

Errors

  • 404 when the integration instance does not exist or is not a Veracore instance.

Authentication: Requires Bearer token.

Request​

Responses​

OK

Response Headers
    Content-Type