Skip to main content
POST
/
submission
/
{displayId}
/
{transactionId}
/
decline
Decline Submission
curl --request POST \
  --url https://app.coverwhale.com/api/v1/submission/{displayId}/{transactionId}/decline \
  --header 'AccessToken: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "decline_note": "Does not meet underwriting criteria"
}
'
{
  "status": "success",
  "submission_number": "<string>",
  "transaction_id": 123,
  "submission_status": "<string>"
}

Authorizations

​
AccessToken
string
header
required

AWS Cognito access token obtained from the /authentication endpoint. Token expires after 3600 seconds.

Headers

​
AccessToken
string
required

Path Parameters

​
displayId
string
required
​
transactionId
integer
required

Body

application/json
​
decline_note
string

Reason for declining

Example:

"Does not meet underwriting criteria"

Response

Submission declined

​
status
string
Example:

"success"

​
submission_number
string
​
transaction_id
integer
​
submission_status
string