SPsphereon-opensource
Runs

List connector route runs

Changed on

Lists execution history for one connector route. Use this route-scoped view when a route detail screen or orchestrator needs only runs belonging to the selected route. Tenant-wide operational dashboards should use /runs and its filters.

get/routes/{routeId}/runs

Request

Path parameters

routeIdstring uuid required

Stable identifier for a connector route.

Example:1e8ff011-2274-4f16-a7dd-bf0b4fd5262f

Stable identifier of a connector route that composes a source operation, destination operation, optional transformation, and trigger policy.

Query parameters

status'QUEUED' | 'RUNNING' | 'SUCCEEDED' | 'FAILED' | 'PARTIALLY_FAILED' | 'CANCELLED'

Execution status of a route run or connector operation run.

Example:SUCCEEDED

Filters connector executions by lifecycle status.

connectorInstanceIdstring uuid

Stable platform identifier for a configured connector instance.

Example:3f6f4f46-24fb-4c35-a7a4-bc6c7f7861f5

Filters connector executions by the registry connector instance id.

invocationBindingIdstring

Stable identifier of the domain invocation binding that caused a connector call.

Example:issuer-config-1:post-issuance:proof-vault

Filters connector executions by Phase 5 invocation binding lineage.

logicalConnectionBindingIdstring

Stable identifier of a tenant, OU, brand, legal-entity, or channel usage binding for a physical connector instance.

Example:brand-a-proof-vault

Filters connector executions by logical connection binding lineage.

physicalConnectorInstanceIdstring uuid

Stable platform identifier for a configured connector instance.

Example:3f6f4f46-24fb-4c35-a7a4-bc6c7f7861f5

Filters connector executions by physical connector instance lineage.

exchangeMode'PLATFORM_INITIATED_PULL' | 'PLATFORM_INITIATED_PUSH' | 'EXTERNALLY_INITIATED_READ' | 'EXTERNALLY_INITIATED_WRITE' | 'SUBSCRIPTION_CALLBACK' | 'BIDIRECTIONAL_SYNC'

Explicit exchange quadrant. Data direction and initiation side remain separate axes in run responses.

Example:PLATFORM_INITIATED_PUSH

Filters connector executions by the Phase 5 data-direction and initiation-side quadrant.

protocolSurface'OID4VCI' | 'OID4VP' | 'FORM' | 'PORTAL' | 'WORKFLOW' | 'APPLICATION'

Product, protocol, form, portal, workflow, or application surface that owns a connector invocation binding.

Example:OID4VCI

Filters connector executions by the product, protocol, form, portal, workflow, or application surface that initiated the run.

correlationIdstring

Filters connector executions by durable route-run correlation id.

pageinteger

Zero-based page index.

sizeinteger

Page size.

Response

Paged connector runs for the route.

Example response

{
  "data": [
    {
      "runId": "9a785884-63ea-4b07-9976-264a1fc595f1",
      "routeId": "1e8ff011-2274-4f16-a7dd-bf0b4fd5262f",
      "status": "PARTIALLY_FAILED",
      "startedAt": "2026-06-18T10:20:00Z",
      "finishedAt": "2026-06-18T10:21:12Z",
      "itemCount": 250,
      "successCount": 247,
      "failureCount": 3
    }
  ],
  "pagination": {
    "limit": 20,
    "offset": 0,
    "page": 0,
    "size": 20,
    "total": 1,
    "totalPages": 1,
    "hasMore": false
  }
}

Changes

  • 60cb8c70871bRevision changes
    • breaking

      removed the enum value EXTERNALLY_INITIATED_READ_FROM_VDX from the query request parameter exchangeMode

    • breaking

      removed the enum value EXTERNALLY_INITIATED_WRITE_INTO_VDX from the query request parameter exchangeMode

    • warning

      added the new EXTERNALLY_INITIATED_READ enum value to the // response property for the response status

    • warning

      added the new EXTERNALLY_INITIATED_WRITE enum value to the // response property for the response status

    • warning

      added the new INBOUND enum value to the // response property for the response status

    • warning

      added the new OUTBOUND enum value to the // response property for the response status

    • info

      added the new enum value EXTERNALLY_INITIATED_READ to the query request parameter exchangeMode

    • info

      added the new enum value EXTERNALLY_INITIATED_WRITE to the query request parameter exchangeMode

    • info

      removed the EXTERNALLY_INITIATED_READ_FROM_VDX enum value from the // response property for the response status

    • info

      removed the EXTERNALLY_INITIATED_WRITE_INTO_VDX enum value from the // response property for the response status

    • info

      removed the INTO_VDX enum value from the // response property for the response status

    • info

      removed the OUT_OF_VDX enum value from the // response property for the response status

    • info

      the //// response's property pattern ^sha256:[0-9a-f]{64}$ was added for the status

    • info

      the //// response's property pattern ^sha256:[0-9a-f]{64}$ was added for the status

    • info

      the //// response's property pattern ^sha256:[0-9a-f]{64}$ was added for the status

    • info

      the //// response's property pattern ^sha256:[0-9a-f]{64}$ was added for the status