Validate Visa

Request

Method: POST

URL: https://{{environment}}.ridx.io/dvs/v1/visa

Headers

Header	Value
token	{{access_token}}
Content-Type	application/json

Request Body

Property	Type	Description
BirthDate	String	Birth date of visa holder, format: YYYY-MM-DD OR YYYY-MM OR YYYYY
GivenName	String	Given name of visa holder, max 49 characters
FamilyName	String	Family name of visa holder, max 49 characters
PassportNumber	String	Passport number to which the visa is attached, format: 7-9 characters
CountryOfIssue	String	Optional. A country code (e.g. "CAN") of the country where the passport was issued

Important Response Data

Property	Type	Description
VerifyDocumentResult	Object	The object containing the reply
VerificationResultCode	String	A value of Y (Yes), N (No), D (Document Error), S (Server Error)
VerificationRequestNumber	String	A receipt number of the request created by RapidID
OriginatingAgencyCode	String	A code representing the customers unique identifier code
ActivityId	String	A activity process id
attributes	Object	An object containing the description on the response
i:type	String	A description on the request response
Errors	Object	This object is returned only when VerificationResultCode value is N (No).This object provides greater insight into why the request did not match the data held by the issuer
Error	Object	This object contains fields such as Field, Message and Source with a description on the error response

Example Requests

Example Request ( Y - Verified )Example Request ( N - Not verified )Example Request ( D - Document error )Example Request ( S - System error in the DVS system )Example Request ( Error response )Example Request ( Expanded Response )

{
  "BirthDate": "1992-06-18",
  "GivenName": "John",
  "FamilyName": "Smith",
  "PassportNumber": "DW126813",
  "CountryOfIssue": "CAN"
}

{
  "BirthDate": "1992-06-18",
  "GivenName": "John",
  "FamilyName": "Smith",
  "PassportNumber": "11111111",
  "CountryOfIssue": "CAN"
}

{
  "BirthDate": "1992-06-18",
  "GivenName": "John",
  "FamilyName": "Smith",
  "PassportNumber": "22222222",
  "CountryOfIssue": "CAN"
}

{
  "BirthDate": "1992-06-18",
  "GivenName": "John",
  "FamilyName": "Smith",
  "PassportNumber": "99999999",
  "CountryOfIssue": "CAN"
}

{
  "BirthDate": "1992-06-18",
  "GivenName": "John",
  "PassportNumber": "DW126813",
  "CountryOfIssue": "CAN"
}

{
  "BirthDate": "1992-06-18",
  "GivenName": "John",
  "MiddleName": "Robert",
  "FamilyName": "Smith",
  "PassportNumber": "88888888",
  "CountryOfIssue": "CAN"
}

Example Responses

Success response ( Y - Verified )Failed response ( N - Not verified )Failed response ( D - Document error )Failed response ( S - System error in the DVS system )Error ResponseExpanded Response

Status: 200 OK

{
  "VerifyDocumentResult": {
    "attributes": {
      "i:type": "VisaResponse"
    },
    "ActivityId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
    "OriginatingAgencyCode": "XXXX",
    "VerificationRequestNumber": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
    "VerificationResultCode": "Y"
  },
  "fieldDetails": {
    "BirthDate": "Full Match",
    "BirthDay": "Full Match",
    "BirthMonth": "Full Match",
    "BirthYear": "Full Match",
    "GivenName": "Full Match",
    "FamilyName": "Full Match",
    "PassportNumber": "Full Match",
    "CountryOfIssue": "Full Match",
    "RegistrationState": "Full Match"
  },
  "rapidID": "check-id"
}

Status: 200 OK

{
  "VerifyDocumentResult": {
    "attributes": {
      "i:type": "VisaResponse"
    },
    "ActivityId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
    "OriginatingAgencyCode": "XXXX",
    "VerificationRequestNumber": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
    "VerificationResultCode": "N"
  },
  "fieldDetails": {
    "BirthDate": "No Match",
    "BirthDay": "No Match",
    "BirthMonth": "No Match",
    "BirthYear": "No Match",
    "GivenName": "No Match",
    "FamilyName": "No Match",
    "PassportNumber": "No Match",
    "CountryOfIssue": "No Match",
    "RegistrationState": "No Match"
  },
  "rapidID": "check-id"
}

Status: 200 OK

{
  "VerifyDocumentResult": {
    "attributes": {
      "i:type": "VisaResponse"
    },
    "ActivityId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
    "OriginatingAgencyCode": "XXXX",
    "VerificationRequestNumber": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
    "VerificationResultCode": "D"
  },
  "fieldDetails": {
    "BirthDate": "No Match",
    "BirthDay": "No Match",
    "BirthMonth": "No Match",
    "BirthYear": "No Match",
    "GivenName": "No Match",
    "FamilyName": "No Match",
    "PassportNumber": "No Match",
    "CountryOfIssue": "No Match",
    "RegistrationState": "No Match"
  },
  "rapidID": "check-id"
}

Status: 200 OK

{
  "VerifyDocumentResult": {
    "attributes": {
      "i:type": "VisaResponse"
    },
    "ActivityId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
    "OriginatingAgencyCode": "XXXX",
    "VerificationRequestNumber": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
    "VerificationResultCode": "S"
  },
  "fieldDetails": {
    "BirthDate": "No Match",
    "BirthDay": "No Match",
    "BirthMonth": "No Match",
    "BirthYear": "No Match",
    "GivenName": "No Match",
    "FamilyName": "No Match",
    "PassportNumber": "No Match",
    "CountryOfIssue": "No Match",
    "RegistrationState": "No Match"
  },
  "rapidID": "check-id"
}

Status: 400 Bad Request

{
  "result": {
    "statuscode": "400",
    "error": [
      "FamilyName needs a value"
    ]
  }
}

Status: 200 OK

{
  "VerifyDocumentResult": {
    "attributes": {
      "i:type": "VisaResponse"
    },
    "ActivityId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
    "OriginatingAgencyCode": "XXXX",
    "VerificationRequestNumber": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
    "VerificationResultCode": "N",
    "Errors": {
      "Error": {
        "Field": "PassportNumber",
        "Message": "Travel document could not be found.",
        "Source": "Issuer"
      }
    }
  },
  "fieldDetails": {
    "BirthDate": "No Match",
    "BirthDay": "No Match",
    "BirthMonth": "No Match",
    "BirthYear": "No Match",
    "GivenName": "No Match",
    "FamilyName": "No Match",
    "PassportNumber": "No Match",
    "CountryOfIssue": "No Match",
    "RegistrationState": "No Match"
  },
  "rapidID": "check-id"
}