POST
/
api
/
applications
/
{application_id}
/
verify
Trigger Verification
curl --request POST \
  --url https://monitoring.safeturf.ai/api/applications/{application_id}/verify \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "services": [
    "<string>"
  ]
}
'
Called when the user hits the Review step. Deduped — if the same EIN/SSN/account was verified before, the result is reused. Middesk is always pending initially (async) — poll /verification after.
application_id
string
required
Application UUID.
services
string[]
default:"[\"MIDDESK\", \"SOCURE\", \"GIACT\"]"
Services to run.
curl -X POST "https://monitoring.safeturf.ai/api/applications/550e8400.../verify" \
  -H "Authorization: Bearer <token>" \
  -d '{"services": ["MIDDESK", "SOCURE", "GIACT"]}'
{
  "results": [
    { "service": "MIDDESK", "status": "pending" },
    { "service": "SOCURE",  "status": "completed", "summary": { "decision": "accept" } },
    { "service": "GIACT",   "status": "completed" }
  ]
}
If Socure returns "summary.action_required": "socure_refer" — call POST /socure-refer to get the DocV link/QR code for ID scanning, then keep polling /verification until the webhook completes it.