Australia Visa Verification (VEVO) API

Overview and Purpose

Overview:

The AU VEVO Check API enables businesses to verify an individual’s Australian visa status and work entitlements as part of identity and compliance workflows.

By integrating the AU VEVO Check API into KYC orchestration systems and onboarding flows, organizations can validate a customer’s visa conditions and right-to-work status in real time without requiring direct integration with government systems.

API Details

Sample cURL

curl --location 'https://api-preproduction.signzy.us/api/v3/kyc/au/vevo-verify' \
--header 'Content-Type: application/json' \
--header 'Authorization:<Auth-Token>' \
--data '{
  "firstName": "IRENE",
  "middleName": "",
  "lastName": "BAUGHMAN",
  "dateOfBirth": "1984-02-12",
  "identityVariables": {
    "passportNumber": "WN09222309",
    "passportIssuerCountry": "POL"
  },
  "consentObtained": {
    "australiaVevo": true
  }
}'

Request Body

{
  "firstName": "IRENE",
  "middleName": "",
  "lastName": "BAUGHMAN",
  "dateOfBirth": "1984-02-12",
  "identityVariables": {
    "passportNumber": "WN09222309",
    "passportIssuerCountry": "POL"
  },
  "consentObtained": {
    "australiaVevo": true
  }
}

Request Body Parameters

Parameter	Type	Description	Required
firstName	String	First name of the individual.	Yes
middleName	String	Middle name of the individual.	No
lastName	String	Last name of the individual.	Yes
dateOfBirth	Date (YYYY-MM-DD)	Date of birth of the individual in YYYY-MM-DD format.	Yes
identityVariables.passportNumber	String	Passport number of the individual to be verified.	Yes
identityVariables.passportIssuerCountry	String	ISO 3-letter country code of the passport issuing country (e.g., POL).	Yes
consentObtained.australiaVevo	Boolean	Indicates whether consent has been obtained for Australia VEVO verification.	Yes

Response Body

{
    "result": {
        "countryCode": "Australia",
        "matchStatus": "Full Match 1+1 Verification",
        "identityVerified": true,
        "serviceResponses": {
            "australiaVevo": {
                "status": 0,
                "sourceStatus": "Successful",
                "identityVerified": true,
                "verifications": {
                    "dateOfBirth": true,
                    "passportNumber": true
                },
                "returnedData": {
                    "visaClass": "WE / 050",
                    "visaExpiryDate": "",
                    "visaGrantDate": ",
                    "visaStream": "Bridging Visa E – BVE",
                    "workEntitlementStatus": 0,
                    "workEntitlementStatusText": "No work entitlement"
                }
            }
        }
    },
    "reason": "Request Successful",
    "code": "S001"
}

Response Body Parameters

Parameter	Type	Description
result	Object	Container for overall verification details.
result.countryCode	String	Country against which the verification was performed.
result.matchStatus	String	Describes the verification match result (e.g., Full Match 1+1 Verification).
result.identityVerified	Boolean	Indicates whether the identity verification was successful (true/false).
result.serviceResponses	Object	Contains service-specific verification responses.
result.serviceResponses.australiaVevo	Object	Response details from the Australia VEVO verification service.
result.serviceResponses.australiaVevo.status	Integer	Internal status code returned by the service (0 typically indicates success).
result.serviceResponses.australiaVevo.sourceStatus	String	Status message received from the source system.
result.serviceResponses.australiaVevo.identityVerified	Boolean	Indicates whether identity was verified successfully by VEVO.
result.serviceResponses.australiaVevo.verifications	Object	Contains field-level verification results.
result.serviceResponses.australiaVevo.verifications.dateOfBirth	Boolean	Indicates whether the date of birth matched the source record.
result.serviceResponses.australiaVevo.verifications.passportNumber	Boolean	Indicates whether the passport number matched the source record.
result.serviceResponses.australiaVevo.returnedData	Object	Contains additional data returned from the VEVO service.
result.serviceResponses.australiaVevo.returnedData.visaClass	String	Visa class and subclass information.
result.serviceResponses.australiaVevo.returnedData.visaExpiryDate	String	Expiry date of the visa (if applicable).
result.serviceResponses.australiaVevo.returnedData.visaGrantDate	String	Date on which the visa was granted (if available).
result.serviceResponses.australiaVevo.returnedData.visaStream	String	Visa stream description.
result.serviceResponses.australiaVevo.returnedData.workEntitlementStatus	Integer	Numeric code representing work entitlement status.
result.serviceResponses.australiaVevo.returnedData.workEntitlementStatusText	String	Human-readable description of work entitlement status.
reason	String	Message describing the overall result of the request.
code	String	System response code indicating success or failure (e.g., S001).

Success Codes

HTTP Status Code	Success Code	Description
200	S001	Request Successful.

Error Code

HTTP Status Code	Error Code	Description
400	E001	Bad Request
401	E101	Unauthorized Access
403	E201	Forbidden
404	E301	Data Not Found
409	E401	Upstream error
429	E501	Rate Limit Exceeded
500	E601	Internal Server Error
503	E701	Service Unavailable
504	E801	Timeout

Getting help

Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.

You can reach out to us at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!