API Reference›Servicing Plane›Voice›Retrieve one voice workflow version

Retrieve one voice workflow version

GEThttps://sandbox.api.lendeasy.ai/v1/servicing/voice-provider/control/api/v1/workflow-versions/{workflowId}/{version}ImplementedBearer token ·READ_SERVICING_VOICE_PROVIDER

One immutable workflow definition version — pass a version number or the literal active. The full node-and-edge definition is the provider’s own shape, forwarded untouched.

Request

curl https://sandbox.api.lendeasy.ai/v1/servicing/voice-provider/control/api/v1/workflow-versions/$WORKFLOW_ID/$VERSION \
  -H "Authorization: Bearer $TOKEN" \
  -H "LendEasy-Tenant: $TENANT"

await fetch(`https://sandbox.api.lendeasy.ai/v1/servicing/voice-provider/control/api/v1/workflow-versions/${workflowId}/${version}`, {
  method: "GET",
  headers: { Authorization: `Bearer ${token}`, "LendEasy-Tenant": tenant },
});

requests.get(
  f"https://sandbox.api.lendeasy.ai/v1/servicing/voice-provider/control/api/v1/workflow-versions/{workflow_id}/{version}",
  headers={"Authorization": f"Bearer {token}", "LendEasy-Tenant": tenant},
)

{
  "id": 12,
  "workflow_id": "collections_demo_v2",
  "version": 3,
  "label": "Tightened opening disclosure",
  "is_active": true,
  "created_at": "2026-07-25T18: 30:00Z",
  "definition": {
    "id": "collections_demo_v2",
    "name": "Collections outreach",
    "outbound": true,
    "nodes": [
      {
        "id": "greeting",
        "type": "conversation",
        "label": "Greeting and identification"
      }
    ],
    "edges": [
      {
        "from": "greeting",
        "to": "payment_discussion",
        "on": "identity_confirmed"
      }
    ]
  }
}

{
  "developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
  "httpStatusCode": "400",
  "defaultUserMessage": "The request could not be applied.",
  "userMessageGlobalisationCode": "validation.msg.validation.errors.exist",
  "errors": []
}

{
  "developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
  "httpStatusCode": "401",
  "defaultUserMessage": "The request could not be applied.",
  "userMessageGlobalisationCode": "error.msg.not.authenticated",
  "errors": []
}

{
  "developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
  "httpStatusCode": "403",
  "defaultUserMessage": "The request could not be applied.",
  "userMessageGlobalisationCode": "error.msg.not.authorized",
  "errors": []
}

{
  "developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
  "httpStatusCode": "404",
  "defaultUserMessage": "The request could not be applied.",
  "userMessageGlobalisationCode": "error.msg.resource.not.found",
  "errors": []
}

Path & query parameters

Field	Type	Description
LendEasy-Tenant required in header	string	Opaque active LendEasy tenant-registry identifier. Supply exactly one instance; no alternate tenant selector is accepted.
workflowId required in path	string	Stable opaque workflow identifier.
version required in path	string	Monotonically increasing resource version.

Request

curl https://sandbox.api.lendeasy.ai/v1/servicing/voice-provider/control/api/v1/workflow-versions/$WORKFLOW_ID/$VERSION \
  -H "Authorization: Bearer $TOKEN" \
  -H "LendEasy-Tenant: $TENANT"

await fetch(`https://sandbox.api.lendeasy.ai/v1/servicing/voice-provider/control/api/v1/workflow-versions/${workflowId}/${version}`, {
  method: "GET",
  headers: { Authorization: `Bearer ${token}`, "LendEasy-Tenant": tenant },
});

requests.get(
  f"https://sandbox.api.lendeasy.ai/v1/servicing/voice-provider/control/api/v1/workflow-versions/{workflow_id}/{version}",
  headers={"Authorization": f"Bearer {token}", "LendEasy-Tenant": tenant},
)

{
  "id": 12,
  "workflow_id": "collections_demo_v2",
  "version": 3,
  "label": "Tightened opening disclosure",
  "is_active": true,
  "created_at": "2026-07-25T18: 30:00Z",
  "definition": {
    "id": "collections_demo_v2",
    "name": "Collections outreach",
    "outbound": true,
    "nodes": [
      {
        "id": "greeting",
        "type": "conversation",
        "label": "Greeting and identification"
      }
    ],
    "edges": [
      {
        "from": "greeting",
        "to": "payment_discussion",
        "on": "identity_confirmed"
      }
    ]
  }
}

{
  "developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
  "httpStatusCode": "400",
  "defaultUserMessage": "The request could not be applied.",
  "userMessageGlobalisationCode": "validation.msg.validation.errors.exist",
  "errors": []
}

{
  "developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
  "httpStatusCode": "401",
  "defaultUserMessage": "The request could not be applied.",
  "userMessageGlobalisationCode": "error.msg.not.authenticated",
  "errors": []
}

{
  "developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
  "httpStatusCode": "403",
  "defaultUserMessage": "The request could not be applied.",
  "userMessageGlobalisationCode": "error.msg.not.authorized",
  "errors": []
}

{
  "developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
  "httpStatusCode": "404",
  "defaultUserMessage": "The request could not be applied.",
  "userMessageGlobalisationCode": "error.msg.resource.not.found",
  "errors": []
}