Skip to main content
POST
/
verify
Verify Documents
curl --request POST \
  --url https://sandbox-umbrella-api.azurewebsites.net/api/services/verify \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "journeyId": "uniqueJourneyIdentifier"
}'
{
  "journeyId": "<string>",
  "status": "verificationComplete",
  "identitySubject": {
    "type": "person",
    "fullName": "Max Mustermann",
    "nameStructure": {
      "firstName": "Max",
      "lastName": "Mustermann",
      "nativeFullName": "Max Mustermann"
    },
    "gender": "M",
    "nationality": "DE",
    "dob": "1990/01/01",
    "addressSingleLine": "123 Main St, City, Country",
    "email": "max.mustermann@example.com",
    "mobileNumber": "+1234567890"
  },
  "authoritativeData": {
    "identityDocument": {
      "type": "passport",
      "idNumber": "123456789",
      "issuingCountry": "DE",
      "expeditor": "BH Neunkirchen",
      "expirationDate": "2030/01/01",
      "verificationChannel": "optical"
    }
  },
  "proofOfWork": {
    "type": "image",
    "titleOfProof": "IDFront",
    "timestampOfProof": "2024/08/01T10:00:00Z"
  },
  "auditTrail": {
    "workId": "abc123",
    "workStatus": "PASS",
    "workStartTst": "2024/08/01T10:00:00Z",
    "workEndTst": "2024/08/01T10:01:00Z",
    "workResult": "Verification successful"
  },
  "fraudAlerts": {
    "fraudAlertDetail": [
      {}
    ],
    "aggregateFraudAlertScore": 0
  },
  "croppedImages": {
    "front": "<string>",
    "portrait": "<string>",
    "signature": "<string>",
    "back": "<string>",
    "selfie": "<string>"
  }
}
For a usage description of the Document Verification Verify Service, please refer to the Document Verification page.

​
Endpoint

POST /verify

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
journeyId
string
required

Unique identifier for the verification journey.

Example:

"uniqueJourneyIdentifier"

Response

Successfully verified documents.

​
journeyId
string

Unique identifier for the verification journey.

​
status
string

Status of the verification process.

Example:

"verificationComplete"

​
identitySubject
object
​
authoritativeData
object
​
proofOfWork
object
​
auditTrail
object
​
fraudAlerts
object
​
croppedImages
object