RIriveterhq
Runs

list runs

Changed on

List the account's runs, newest first. Every async operation shows up here — enrichment runs, dataset builds, extractions, and quick searches.

Filter by type (comma-separated), status, enrichment_id, dataset_id, monitor_id, and created_after / created_before (ISO 8601). Paginate with page / per_page.

Pass ids (comma-separated, up to 100 run ids) to get those runs' full status objects (same shape as GET /runs/{id}) in one call; not_found lists ids not on this account. Filters and pagination are ignored.

get/runs

Request

Query parameters

idsstring

Comma-separated run ids, up to 100. Returns their full status objects plus not_found; other filters ignored.

typestring

Comma-separated run types: enrichment, dataset_build, extraction, scrape, quick_search, search_agent

status'pending' | 'enqueued' | 'processing' | 'success' | 'stopped'

Filter by run status

enrichment_idstring

Only runs of this enrichment (enr_...)

dataset_idstring

Only runs on this dataset (ds_...) — its fills and its list generations

monitor_idstring

Only runs of this monitor (mon_...)

created_afterstring date-time
created_beforestring date-time
pageinteger
per_pageinteger

Response

Runs listed (with ids, the named runs' full status envelopes plus not_found)

not_foundstring[]

With ids only — the requested ids that are not runs on this account

Example response

{
  "runs": [
    {
      "id": "run_018f6a70-1234-7abc-89ab-0123456789ab",
      "type": "enrichment",
      "status": "processing",
      "progress": {
        "percent_complete": 40,
        "estimated_seconds_remaining": 90,
        "elapsed_seconds": 60,
        "completed_cells": 4,
        "total_cells_expected": 10,
        "not_found_cells": 0
      },
      "credits_used": 2.5,
      "credit_detail": {
        "estimate": {
          "minimum": 0,
          "maximum": 10,
          "charged_upfront": false
        },
        "credits_used": 2.5
      },
      "app_url": "https://app.riveterhq.com/runs/run_018f6a70-1234-7abc-89ab-0123456789ab",
      "result_url": "https://api.riveterhq.com/v1/runs/run_018f6a70-1234-7abc-89ab-0123456789ab/result",
      "started_at": "2026-01-15T12:00:00Z",
      "finished_at": null,
      "error": null,
      "enrichment_id": "enr_018f5b60-1234-7abc-89ab-0123456789ab",
      "enrichment_name": "My Enrichment"
    }
  ]
}

Changes

  • fac56b649559Revision changes
    • warning

      removed the optional property ////// from the response with the status

  • dcb4d45ade1aRevision changes
    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property //////////// to the response with the status

    • info

      added the optional property //////////// to the response with the status