Validate a marriage certificate API

POST
/dvs/marriage
LIVE

Validates an Australian marriage certificate against the DVS. Confirms both parties' names, the event date and registration details against the issuing state's Registry of Births, Deaths and Marriages.

calendar_today Request a Demo Contact Sales

Example Request

POST
request.json
key Auth: BearerAuth 
{
  "consent": true,
  "first_name1": "John",
  "last_name1": "Smith",
  "first_name2": "Mary",
  "last_name2": "Jones",
  "event_date": "1980-01-01",
  "certificate_number": "123456789",
  "state": "VIC"
}

Request Schema

preflight
Required
boolean

Input validation only.

consent
Required
boolean

Individual's consent.

first_name1 last_name1
Required
string

Name of the first person.

first_name2 last_name2
Required
string

Name of the second person.

event_date
Required
string

Date of marriage.

certificate details
Required
string

State-specific identifiers. Same rules as birth and death certificates.

state
Required
enum

State of issue.

Available Response Data

3 Data Points
01
monitor_heart

verification_result_code: Y, N, D or S

02
tag

activity_id and verification_request_number

03
data_object

additional_information array

for example MC-001 Family Name does not match

lock Full API documentation provided after vetting from our compliance team.
By The Numbers

API Data Scale & Coverage tag

Unmatched data depth to power your compliance and verification workflows.

50M+
Phone & Email Records
40M+
Adverse Court Records
2BN+
Australian Universe Records
18M+
Real Estate Records
7M+
Deceased Records
980M+
Social Media & Employment Records
Practical Applications

Technical Use Cases tag

house

Joint mortgage applications

Lenders verifying marriage status as part of joint applicant due diligence on mortgages and refinancing.

account_balance_wallet

Beneficiary and joint-account setup

Verify marital status when adding a spouse as a beneficiary on superannuation or a joint signatory on financial accounts.

Trust & Assurance

Compliance & Security tag

Enterprise-grade infrastructure audited against the standards your regulators require.

verified_user
ISO 27001 Certified
enhanced_encryption
AES-256 Encryption
public
Australian Data Sovereignty
Integration & Support

Common Questions tag

Everything you need to know about implementation details and compliance infrastructure.

rocket_launch Implementation

Do both names have to match exactly?

add

Yes. Both the first_name and last_name pairs have to be on the certificate. Like other DVS checks, the result is binary (Y / N / D). No details from the certificate itself are returned.

Try it Live

API Testing Sandbox tag

Test the Validate a marriage certificate API directly in your browser with live mock data and see instant results.

rocket_launch Request Sandbox Access

Access to live sandbox environments requires manual approval from our compliance team.

(03) 9948 4089
Request a Demo
BACK TO TOP