vSure Visa Checks API v2

Headless RESTful API offering Visa Checks for Australia and New Zealand

Brand banner

vSure Visa Checks API v2

vSure offers a modern, developer friendly API allowing you to add Australian and/or New Zealand Visa checks into your application(s).

vSure Visa Checks API v2 - Hero Image

POSTMAN Collection

You can find the vSure v2 API in the POSTMAN marketplace, which you can find via the following direct link: https://www.postman.com/vsure-developers You will need to use POSTMAN environment to set-up the variables and for the vSure v2 API POSTMAN col...

Authentication

The vSure Visa Check API uses OAuth2 to authenticate your application. Applications are issued a client_id and a client_secret, and you exchange these credentials securely to receive an access token. You can then use the access token to make API call...

Customer Authority

vSure acts on your / your client's behalf when performing a visa check. In New Zealand, visa checks MUST BE performed with reference to your/your client's RealMe account details. In NZ specifically you need to create a 'customer authority' and store...

Visa Checks - Australia

The Visa Check endpoint is where all the heavy lifting gets done by vSure to submit and return visa check results. vSure checks can be run for Australia and/or New Zealand across various use cases such as: Work Rights check Study Visa enquiry Austra...

Visa Checks - New Zealand

The Visa Check endpoint is where all the heavy lifting gets done by vSure to submit and return visa check results. vSure checks can be run for Australia and/or New Zealand across various use cases such as: Work Rights check Study Visa enquiry Austra...

Visa Check Lifecycle

Visa checks happen asynchronously to your API calls, which means you'll need to check the status of a check before acting on any data returned from the API. Simple Sequence The following sequence diagram shows the overall steps involved in performing...

Result Codes / Errors

Possible Results - Visa Check vSure operates in Australia and New Zealand. For cyber security reasons we block international traffic. If you or your developers are overseas they may receive an error from CloudFlare along the lines of "Sorry, yo...

Upgrade from v1 to v2

vSure has offered its v1 Visa Check API in market for close to a decade. We have a large number of clients who will transition from v1 to v2. Here's the key FAQs around v1 vs v2. How long do we have? Changes to Department of Home Affairs systems in J...

Resources

It is our goal at vSure to deliver the optimal developer experience. Where it makes sense, we add additional resources to make your life easier and help you deliver an optimal user experience for your customers/users/staff/candidates. Our current add...

Visa Check PDF

Australia In Australia, vSure Study and MARA agent checks, will return the same PDF as would be retreived by a manual visa check through the Department of Home Affairs Immigration website. For our most common check type, Work Rights, vSure offers thr...

Test Cases - Australia | Work Visa Check Type

The following test cases are available within the aus:sandbox scope for 'work' visa checks. Work is the default visa check type and covers most use cases apart from Study Visa and Migration Agent checks. Please note that the family_name and given_nam...

Test Cases - Australia | Study Visa Check Type

The following test cases are available within the aus:sandbox scope for 'Study' Visa checks: Please note that the family_name and given_name (below as John Smith), can be anything you want, without affecting the response. Feel free to use your own na...

Test Cases - New Zealand | Visa Verification

The following test cases are available within the nzl:sandbox scope. NOTE: data must match the NZ Immigration database exactly to return a verfiy a visa. The "Verification" check type requires exact match of: Family Name Passport Country P...

Test Cases - New Zealand | Employer VisaView

The following test cases are available within the nzl:sandbox scope. NOTE: data must match the NZ Immigration database exactly to return a verfiy a visa. The "Employer" CheckType requires exact match of: Family Name Passport Country Passpo...

Test Cases - Australia | MARA Agent Check

The following test cases are available within the aus:sandbox scope for 'agent' visa checks. Please note that the family_name and given_name, can be anything you want, without affecting the response. Feel free to use your own names to differentiate t...

Token & Rate Limits

Token Limits vSure leverages Auth0 M2M tokens. Tokens survive 24 hours. We ask that you reuse tokens and do not create new tokens for each check. A Token limit of 48 per 24 hours applies to each client ID. Rate Limits vSure works with an array of dif...

Maintenance Windows & Outages

The Australian Department of Home Affairs have official maintenance windows that can impact vSure's ability to perform visa checks. These are: Mondays Midnight to 4 am Wednesdays 5 am to 8 am Weekends 2 pm Saturday to 9 am Sunday Our experience is th...

Status Page

Subscribe to our Statuspage We recommend subscribing to our Statuspage for alerts and updates on outages: https://vsure.statuspage.io/

ISO 27001:2022 Certified

Rest assured, vSure is ISO 27001:2022 Certified. ✔️ Best in class platform and data security ✔️ ISO 27001:2022 Certified ✔️ Bank grade encryption, of data in transit and at rest ✔️ Australian located, Tier 1, secure data centres ✔️ Regular, independ...

Change Log

2026 - 02 - 10 Jurisdiction: AUS and NZ New response header code for visa check. vSure V2 API has provided a 201 Created response to visa check requests since release. As it turns out this was incorrect as a result of a bug in a library we use. As th...