GET
/
api
/
dealers
/
{dealerId}
Get Dealer Status
curl --request GET \
  --url https://monitoring.safeturf.ai/api/dealers/{dealerId} \
  --header 'Authorization: Basic <encoded-value>'
{
  "status": "<string>",
  "caseNumber": 123,
  "checks": {},
  "documents": [
    {}
  ]
}
This endpoint requires HTTP Basic authentication, with the same client credentials as Submit a Dealer.
Returns the dealer’s underwriting status, its case number, a count of checks by outcome and the documents on file. Poll no more than once a minute.

​
Request

​
dealerId
string
required
Your dealerId from the submission.
curl "https://monitoring.safeturf.ai/api/dealers/360-0042" \
  -u "$CLIENT_ID:$CLIENT_SECRET"

​
Response

{
  "dealerId": "360-0042",
  "legalName": "Acme Roofing LLC",
  "status": "in_review",
  "caseNumber": 85601,
  "submittedAt": "2026-10-27T17:33:15+00:00",
  "caseOpenedAt": "2026-10-27T17:33:20+00:00",
  "checks": { "total": 42, "verified": 30, "needsReview": 9, "pending": 2, "failed": 1, "notApplicable": 0 },
  "documents": [
    { "documentId": "6f1c2d3e-8a9b-4c5d-9e0f-1a2b3c4d5e6f", "documentType": "w9", "filename": "w9.pdf", "uploadedAt": "2026-10-27T17:33:16+00:00" }
  ]
}
​
status
string
ValueMeaning
receivedSubmission accepted; the dealer is being created.
checks_runningAutomated verification in progress.
in_reviewWith an underwriter.
on_holdWaiting on information.
approvedApproved.
declinedDeclined.
cancelledCancelled.
​
caseNumber
integer
Underwriting case number, once the case is open. Quote it when you contact Safeturf about this dealer.
​
checks
object
Count of verification checks by outcome.
​
documents
object[]
Every document on file for the dealer.
StatusMeaning
401Missing or wrong client credentials.
404No dealer with this dealerId.