Skip to main content
Use the underwritingApplications query to retrieve the current status of an underwriting application. This is useful when verifying whether an application is ready for submission, confirming a state before taking action, or diagnosing unexpected behavior.
Prefer webhook events over polling for production integrations. Use this query for one-off checks or when troubleshooting.

​
Query an application

Pass the application id to retrieve its current status and timestamps. 
query CheckApplicationStatus($input: UnderwritingApplicationInput!) {
  underwritingApplications(input: $input) {
    items {
      id
      applicationStatus
      createdDateTime
      updatedDateTime
    }
  }
}

​
Response

Success
{
  "data": {
    "underwritingApplications": {
      "items": [
        {
          "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "applicationStatus": "PROCESSING",
          "createdDateTime": "2024-01-15T10:00:00Z",
          "updatedDateTime": "2024-01-15T11:30:00Z"
        }
      ]
    }
  }
}

​
Status values

The applicationStatus field reflects the application’s current position in the underwriting lifecycle.
StatusDescription
CREATEDApplication created but not yet submitted
SUBMITTEDSubmitted and queued for automated processing
PROCESSINGAutomated checks are running
PENDINGManual underwriting review is required
DECISIONEDA final decision has been reached (Approved, Declined, or Withdrawn)
SUBMISSION_INVALIDSubmission failed due to validation errors — correct and resubmit
SUBMISSION_FAILEDSubmission failed due to a system error — retry the submission
For the full list of status values, see UnderwritingApplicationStatus.
ScenarioBen attempts to resubmit his keyboard business application after fixing a validation error. He first checks the status and confirms the application is in SUBMISSION_INVALID state, which means it is eligible for resubmission.

​
Next steps