/api/applications/{applicationId}/reject

POST /api/applications/{applicationId}/reject

Reject an application

Rejects an application and updates its status to DECLINED. This endpoint will:

Update the application status to DECLINED
Log the activity in underwriting activity log
Create a decision record in underwriting decisions table
Create an internal note with rejection reason
Optionally send a notification email to the applicant

Requires writeUnderwriting permission.

Valid source states for rejection:

INITIAL_REVIEW
DOCUMENTATION_REVIEW
PENDING_INFORMATION
TRIAGED
IN_UNDERWRITING
ADDITIONAL_REVIEW_REQUIRED
UNDERWRITING_HOLD

Required Parameters

applicationId path string

The unique ID of the application

{
  "reason": "Insufficient business history"
}

{
  "reason": "Insufficient business history",
  "additionalNotes": "Business has been operating for less than 6 months",
  "sendEmail": false,
  "toEmail": "merchant@example.com"
}

Try it out

Output:

Responses

Description

Application rejected successfully

{
  "success": true,
  "message": "Application rejected successfully",
  "data": {
    "applicationId": "string",
    "newStatus": "DECLINED",
    "reason": "string",
    "emailSentTo": "merchant@example.com"
  }
}

Description

Bad request - validation error or invalid state transition

{
  "error": "Cannot reject application from current status APPROVED"
}

Description

Unauthorized - user not authenticated

{
  "error": "Unauthorized"
}

Description

Forbidden - user lacks writeUnderwriting permission

{
  "error": "Insufficient permissions"
}

Description

Application not found

{
  "error": "Application not found"
}

Description

Internal server error

{
  "error": "Internal server error"
}

Or the swagger.yaml spec this documentation was generated from: /applications/[applicationId]/reject/swagger.yaml