Get pipeline runs

GET/api/v1/data-pipelines/runs/{runId}

Parameters

Path parameters
Field	Type	Required	Nullable	Default
runId	string	required	non-null	—

Query parameters: none.

200

Response fields
Field	Type	Required	Nullable	Default
data	object	required	non-null	—
data.id	string	required	non-null	—
data.companyId	string	required	non-null	—
data.workspaceId	string	required	non-null	—
data.pipelineId	string	required	non-null	—
data.versionId	string	required	non-null	—
data.sourceId	string	optional	non-null	—
data.mode	"dry_run" \| "promote"	required	non-null	—
data.trigger	"manual" \| "upload" \| "schedule" \| "webhook" \| "api"	required	non-null	—
data.status	"queued" \| "validating" \| "running" \| "completed" \| "failed" \| "partial_failure" \| "cancelled"	required	non-null	—
data.actorMemberId	string	required	non-null	—
data.counts	object	required	non-null	—
data.counts.rowsRead	integer	required	non-null	—
data.counts.rowsValid	integer	required	non-null	—
data.counts.rowsInvalid	integer	required	non-null	—
data.counts.entitiesResolved	integer	required	non-null	—
data.counts.entitiesMinted	integer	required	non-null	—
data.counts.entitiesPromoted	integer	required	non-null	—
data.counts.sourceObjectsSeen	integer	optional	non-null	—
data.counts.sourceObjectsDropped	integer	optional	non-null	—
data.counts.sourceExtractsDropped	integer	optional	non-null	—
data.counts.sourceObjectsLanded	integer	optional	non-null	—
data.errorSummary	array	required	non-null	—
data.jobId	string	optional	non-null	—
data.createdAt	string	required	non-null	—
data.startedAt	string	optional	non-null	—
data.completedAt	string	optional	non-null	—
data.artifacts	array	required	non-null	—

Declared failures
DATA_PIPELINES_RUN_NOT_FOUND	404 — not retryable

This method returns the current state it read.

Schematic only. Replace placeholders with real values and include all required nested fields.

GET /api/v1/data-pipelines/runs/{runId} HTTP/1.1
Authorization: Bearer <token>
x-merulan-workspace-id: <workspace-id>