POST
/
api
/
applications
/
{application_id}
/
socure-refer
Socure DocV
curl --request POST \
  --url https://monitoring.safeturf.ai/api/applications/{application_id}/socure-refer \
  --header 'Authorization: Basic <encoded-value>'
{
  "docv_url": "<string>",
  "qrcode": "<string>",
  "event_id": "<string>"
}
Call when /verify returns summary.action_required === "socure_refer". Creates a Socure DocV session and returns a hosted ID-scan link + QR code. Show the user the QR code / link — they scan their ID on their phone. When complete, Socure fires a webhook that marks the check as completed. Keep polling /verification until it resolves. No request body.
​
application_id
string
required
Application UUID.
curl -X POST "https://monitoring.safeturf.ai/api/applications/550e8400.../socure-refer" \
  -H "Authorization: Bearer <token>"

{
  "application_id": "550e8400-e29b-41d4-a716-446655440000",
  "integration_request_id": "ir-uuid",
  "docv_url": "https://verify.socure.us/...",
  "qrcode": "data:image/png;base64,...",
  "event_id": "socure-event-id"
}
​
docv_url
string
Direct link to the Socure ID-scan page. Show as a button or redirect.
​
qrcode
string
Base64 PNG data URI. Render as <img src={qrcode} /> for mobile scanning.
​
event_id
string
Socure eventId — used internally to match the webhook callback.