API Reference›Servicing Plane›Connector callbacks›Submit a voice disposition

Submit a voice disposition

POSThttps://sandbox.api.lendeasy.ai/v1/servicing/voice-dispatches/{dispatchId}/dispositionImplementedConnector callbackConnector authority ·Dispatch-bound task-scoped worker token

Validates one closed primary/secondary outcome set and applies its interaction, case, task, consent, promise, payment, and handoff effects idempotently.

Request

curl -X POST https://sandbox.api.lendeasy.ai/v1/servicing/voice-dispatches/$DISPATCH_ID/disposition \
  -H "X-LendEasy-Voice-Task-Token: $DISPATCH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "agentDispositionRef": "voice-result-731",
  "outcomeCode": "PROMISE_TO_PAY_RECORDED",
  "secondaryOutcomeCodes": [],
  "occurredAt": "2026-07-25T19: 12: 31-07: 00",
  "verificationState": "VERIFIED",
  "runtimeProvenance": {
    "runtimeVersion": "collections-voice-2026.07.25",
    "evidenceRef": "worker-eval-731"
  },
  "transcriptRef": "call-transcript-731",
  "recordingState": "RECORDED",
  "promise": {
    "planType": "SINGLE",
    "promiseDate": "2026-08-01",
    "promiseAmount": {
      "amount": 250,
      "currency": "USD"
    },
    "reason": "Customer committed during the verified call."
  }
}'

await fetch(`https://sandbox.api.lendeasy.ai/v1/servicing/voice-dispatches/${dispatchId}/disposition`, {
  method: "POST",
  headers: { "X-LendEasy-Voice-Task-Token": dispatchToken, "Content-Type": "application/json" },
  body: JSON.stringify({
  "agentDispositionRef": "voice-result-731",
  "outcomeCode": "PROMISE_TO_PAY_RECORDED",
  "secondaryOutcomeCodes": [],
  "occurredAt": "2026-07-25T19: 12: 31-07: 00",
  "verificationState": "VERIFIED",
  "runtimeProvenance": {
    "runtimeVersion": "collections-voice-2026.07.25",
    "evidenceRef": "worker-eval-731"
  },
  "transcriptRef": "call-transcript-731",
  "recordingState": "RECORDED",
  "promise": {
    "planType": "SINGLE",
    "promiseDate": "2026-08-01",
    "promiseAmount": {
      "amount": 250,
      "currency": "USD"
    },
    "reason": "Customer committed during the verified call."
  }
}),
});

requests.post(
  f"https://sandbox.api.lendeasy.ai/v1/servicing/voice-dispatches/{dispatch_id}/disposition",
  headers={"X-LendEasy-Voice-Task-Token": dispatch_token},
  json={
  "agentDispositionRef": "voice-result-731",
  "outcomeCode": "PROMISE_TO_PAY_RECORDED",
  "secondaryOutcomeCodes": [],
  "occurredAt": "2026-07-25T19: 12: 31-07: 00",
  "verificationState": "VERIFIED",
  "runtimeProvenance": {
    "runtimeVersion": "collections-voice-2026.07.25",
    "evidenceRef": "worker-eval-731"
  },
  "transcriptRef": "call-transcript-731",
  "recordingState": "RECORDED",
  "promise": {
    "planType": "SINGLE",
    "promiseDate": "2026-08-01",
    "promiseAmount": {
      "amount": 250,
      "currency": "USD"
    },
    "reason": "Customer committed during the verified call."
  }
},
)

{
  "dispatchId": 731,
  "agentDispositionRef": "voice-result-731",
  "accepted": true,
  "interactionId": 3004,
  "outcomeCode": "PROMISE_TO_PAY_RECORDED",
  "secondaryOutcomeCodes": [],
  "effects": [
    {
      "type": "PROMISE",
      "target": "case: 1001",
      "status": "COMPLETED",
      "ref": "6101"
    }
  ]
}

{
  "error": "The callback body is invalid."
}

{
  "error": "Invalid or missing connector authority."
}

{
  "error": "No visible voice dispatch exists."
}

{
  "error": "The callback conflicts with current dispatch state."
}

Path & query parameters

Field	Type	Description
dispatchId required in path	integer	Positive numeric dispatch identifier.

Body parameters

Field	Type	Description
agentDispositionRef required	string
outcomeCode required	string	One exact primary code from the closed 58-code registry. One of PAYMENT_CAPTURED · PARTIAL_PAYMENT_CAPTURED · PAY_AHEAD_PAYMENT_CAPTURED · LOAN_PAYOFF_CAPTURED · SCHEDULED_PAYMENT_CAPTURED · LATE_FEE_WAIVED_AND_PAYMENT_CAPTURED · LATE_FEE_WAIVED_AND_SCHEDULED_PAYMENT_CAPTURED · PROMISE_TO_PAY_RECORDED · PAYMENT_LINK_SENT · PAYMENT_LINK_SENT_SAME_DAY · PAYOFF_LINK_SENT · PAYOFF_INFO_PROVIDED · EXISTING_SCHEDULED_PAYMENT_NOTED · BORROWER_WILL_PAY_THROUGH_PORTAL_TODAY · AGENT_CALLBACK_SCHEDULED · AGENT_CALLBACK_SCHEDULED_AFTER_DISCONNECT · AGENT_CALLBACK_SCHEDULED_WITH_OFF_HOURS_CONSENT · HUMAN_CALLBACK_SCHEDULED · LANGUAGE_SPECIALIST_CALLBACK_REQUESTED · BORROWER_WILL_CALL_BACK · DISPUTE_CAPTURED · DISPUTE_PENDING_REVIEW · DEBT_DENIAL_ESCALATED · TERMS_DISPUTE_ESCALATED · PRIOR_REP_PROMISE_ESCALATED · PRIOR_REP_PROMISE_REVIEW_DECLINED · HARDSHIP_AFFORDABILITY_REVIEW_REQUESTED · HARDSHIP_CALLBACK_REQUESTED · HARDSHIP_OPTION_REVIEW_REQUESTED · HARDSHIP_SETTLEMENT_REVIEW_REQUESTED · HARDSHIP_PARTIAL_PAYMENT_AND_CALLBACK · HARDSHIP_FULL_CURE_SCHEDULED · HARDSHIP_SPLIT_CURE_SCHEDULED · HARDSHIP_ONE_PAYMENT_DEFERRAL_APPROVED · HARDSHIP_DISASTER_RELIEF_REVIEW_REQUESTED · DO_NOT_CALL · WRITTEN_ONLY_CONTACT_REQUESTED · AI_CALL_CONSENT_REVOKED · RECORDING_CONSENT_REVOKED · BANKRUPTCY_OR_ATTORNEY_NOTED_CALL_ENDED · MILITARY_OR_SCRA_NOTED · MILITARY_OR_SCRA_SPECIALIST_CALLBACK_REQUESTED · DECEASED_BORROWER_NOTED · SELF_HARM_OR_DISTRESS_ESCALATED · REGULATORY_COMPLAINT_ESCALATED · NO_ANSWER · VOICEMAIL_LEFT · WRONG_PARTY · BORROWER_UNAVAILABLE_NO_DETAILS_DISCLOSED · CALL_DROPPED_BEFORE_VERIFICATION · VERIFICATION_FAILED · VERIFICATION_REFUSED · THIRD_PARTY_MANAGER_NOTED · CALL_TERMINATED_HOSTILE · NO_RESOLUTION · NO_RESOLUTION_LOW_CONFIDENCE · PAYMENT_FAILED_FOLLOW_UP · PAYMENT_REVERSAL_REQUESTED.
secondaryOutcomeCodes optional	array<string>	Compatible exact secondary codes; none may equal outcomeCode.
occurredAt required	string
verificationState required	string	One of `UNVERIFIED · PARTIALLY_VERIFIED · VERIFIED · NOT_APPLICABLE`.
confidence optional	number
runtimeProvenance required	object
runtimeVersion	string
evidenceRef	string
transcriptRef optional	string
payments optional	array<object>	Required only for a submitted payment-bearing outcome; authorizationRef values must be unique.
outcomeCode	string	One of PAYMENT_CAPTURED · PARTIAL_PAYMENT_CAPTURED · PAY_AHEAD_PAYMENT_CAPTURED · LOAN_PAYOFF_CAPTURED · SCHEDULED_PAYMENT_CAPTURED · LATE_FEE_WAIVED_AND_PAYMENT_CAPTURED · LATE_FEE_WAIVED_AND_SCHEDULED_PAYMENT_CAPTURED · PROMISE_TO_PAY_RECORDED · PAYMENT_LINK_SENT · PAYMENT_LINK_SENT_SAME_DAY · PAYOFF_LINK_SENT · PAYOFF_INFO_PROVIDED · EXISTING_SCHEDULED_PAYMENT_NOTED · BORROWER_WILL_PAY_THROUGH_PORTAL_TODAY · AGENT_CALLBACK_SCHEDULED · AGENT_CALLBACK_SCHEDULED_AFTER_DISCONNECT · AGENT_CALLBACK_SCHEDULED_WITH_OFF_HOURS_CONSENT · HUMAN_CALLBACK_SCHEDULED · LANGUAGE_SPECIALIST_CALLBACK_REQUESTED · BORROWER_WILL_CALL_BACK · DISPUTE_CAPTURED · DISPUTE_PENDING_REVIEW · DEBT_DENIAL_ESCALATED · TERMS_DISPUTE_ESCALATED · PRIOR_REP_PROMISE_ESCALATED · PRIOR_REP_PROMISE_REVIEW_DECLINED · HARDSHIP_AFFORDABILITY_REVIEW_REQUESTED · HARDSHIP_CALLBACK_REQUESTED · HARDSHIP_OPTION_REVIEW_REQUESTED · HARDSHIP_SETTLEMENT_REVIEW_REQUESTED · HARDSHIP_PARTIAL_PAYMENT_AND_CALLBACK · HARDSHIP_FULL_CURE_SCHEDULED · HARDSHIP_SPLIT_CURE_SCHEDULED · HARDSHIP_ONE_PAYMENT_DEFERRAL_APPROVED · HARDSHIP_DISASTER_RELIEF_REVIEW_REQUESTED · DO_NOT_CALL · WRITTEN_ONLY_CONTACT_REQUESTED · AI_CALL_CONSENT_REVOKED · RECORDING_CONSENT_REVOKED · BANKRUPTCY_OR_ATTORNEY_NOTED_CALL_ENDED · MILITARY_OR_SCRA_NOTED · MILITARY_OR_SCRA_SPECIALIST_CALLBACK_REQUESTED · DECEASED_BORROWER_NOTED · SELF_HARM_OR_DISTRESS_ESCALATED · REGULATORY_COMPLAINT_ESCALATED · NO_ANSWER · VOICEMAIL_LEFT · WRONG_PARTY · BORROWER_UNAVAILABLE_NO_DETAILS_DISCLOSED · CALL_DROPPED_BEFORE_VERIFICATION · VERIFICATION_FAILED · VERIFICATION_REFUSED · THIRD_PARTY_MANAGER_NOTED · CALL_TERMINATED_HOSTILE · NO_RESOLUTION · NO_RESOLUTION_LOW_CONFIDENCE · PAYMENT_FAILED_FOLLOW_UP · PAYMENT_REVERSAL_REQUESTED.
instrumentId	string
amount	object
valueDate	string
authorizationRef	string
reversal optional	object	Required only for PAYMENT_REVERSAL_REQUESTED.
paymentRef	string
promise optional	object \| object	Required only for PROMISE_TO_PAY_RECORDED.
planType	string	One of `SINGLE · INSTALLMENT`.
promiseDate	string
promiseAmount	object
installments	array<object>
schedule	object
reason	string
evidenceIds	array<integer>
callback optional	object	Required only for a submitted callback outcome.
scheduledAt	string
consentChanges optional	array<object>	Required only when the submitted outcome fixes a consent change.
consentType	string	One of `ARTIFICIAL_VOICE · UNUSUAL_TIME`.
operation	string	One of `REVOKE · GRANT`.
effectiveAt	string
evidenceRef	string
recordingState optional	string	Required for a connected interaction and rejected for an unconnected one. One of `NOT_RECORDED · POLICY_PENDING · RECORDED · STOPPED · BLOCKED · UNAVAILABLE`.
escalationFlags optional	array<string>
handoffSummary optional	string	Required only when the submitted outcome creates human work.

Request

curl -X POST https://sandbox.api.lendeasy.ai/v1/servicing/voice-dispatches/$DISPATCH_ID/disposition \
  -H "X-LendEasy-Voice-Task-Token: $DISPATCH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "agentDispositionRef": "voice-result-731",
  "outcomeCode": "PROMISE_TO_PAY_RECORDED",
  "secondaryOutcomeCodes": [],
  "occurredAt": "2026-07-25T19: 12: 31-07: 00",
  "verificationState": "VERIFIED",
  "runtimeProvenance": {
    "runtimeVersion": "collections-voice-2026.07.25",
    "evidenceRef": "worker-eval-731"
  },
  "transcriptRef": "call-transcript-731",
  "recordingState": "RECORDED",
  "promise": {
    "planType": "SINGLE",
    "promiseDate": "2026-08-01",
    "promiseAmount": {
      "amount": 250,
      "currency": "USD"
    },
    "reason": "Customer committed during the verified call."
  }
}'

await fetch(`https://sandbox.api.lendeasy.ai/v1/servicing/voice-dispatches/${dispatchId}/disposition`, {
  method: "POST",
  headers: { "X-LendEasy-Voice-Task-Token": dispatchToken, "Content-Type": "application/json" },
  body: JSON.stringify({
  "agentDispositionRef": "voice-result-731",
  "outcomeCode": "PROMISE_TO_PAY_RECORDED",
  "secondaryOutcomeCodes": [],
  "occurredAt": "2026-07-25T19: 12: 31-07: 00",
  "verificationState": "VERIFIED",
  "runtimeProvenance": {
    "runtimeVersion": "collections-voice-2026.07.25",
    "evidenceRef": "worker-eval-731"
  },
  "transcriptRef": "call-transcript-731",
  "recordingState": "RECORDED",
  "promise": {
    "planType": "SINGLE",
    "promiseDate": "2026-08-01",
    "promiseAmount": {
      "amount": 250,
      "currency": "USD"
    },
    "reason": "Customer committed during the verified call."
  }
}),
});

requests.post(
  f"https://sandbox.api.lendeasy.ai/v1/servicing/voice-dispatches/{dispatch_id}/disposition",
  headers={"X-LendEasy-Voice-Task-Token": dispatch_token},
  json={
  "agentDispositionRef": "voice-result-731",
  "outcomeCode": "PROMISE_TO_PAY_RECORDED",
  "secondaryOutcomeCodes": [],
  "occurredAt": "2026-07-25T19: 12: 31-07: 00",
  "verificationState": "VERIFIED",
  "runtimeProvenance": {
    "runtimeVersion": "collections-voice-2026.07.25",
    "evidenceRef": "worker-eval-731"
  },
  "transcriptRef": "call-transcript-731",
  "recordingState": "RECORDED",
  "promise": {
    "planType": "SINGLE",
    "promiseDate": "2026-08-01",
    "promiseAmount": {
      "amount": 250,
      "currency": "USD"
    },
    "reason": "Customer committed during the verified call."
  }
},
)

{
  "dispatchId": 731,
  "agentDispositionRef": "voice-result-731",
  "accepted": true,
  "interactionId": 3004,
  "outcomeCode": "PROMISE_TO_PAY_RECORDED",
  "secondaryOutcomeCodes": [],
  "effects": [
    {
      "type": "PROMISE",
      "target": "case: 1001",
      "status": "COMPLETED",
      "ref": "6101"
    }
  ]
}

{
  "error": "The callback body is invalid."
}

{
  "error": "Invalid or missing connector authority."
}

{
  "error": "No visible voice dispatch exists."
}

{
  "error": "The callback conflicts with current dispatch state."
}