Verification API for agencies

OpenAPI 3 (JSON) →

For governments, embassies, courts, immigration and banks that need to check marital status from their own systems (visa applications, marriage registration offices, KYC). Keys are issued only by the WMR registrar.

Check status by national ID

GET https://worldmarriageregistry.com/api/v1/status?country=BD&nid=1988331000002&purpose=Visa%20application%20123
Authorization: Bearer wmr_live_xxxxxxxxxxxxxxxx

Response:

{
  "registered": true,
  "married": true,
  "active_marriages": 1,
  "ended_marriages": 1,
  "married_since": "2021",
  "checked_at": "2026-11-15 06:30:00 UTC"
}

The purpose parameter is required and stored in the log.
No name, photo, address, spouse or document is ever returned.
The person can see in their own account which organisation checked them and when.
National keys may only check their own country. Daily limits apply (HTTP 429).

Check a certificate

GET https://worldmarriageregistry.com/api/v1/certificate/MC-BD-XXXX-000002
Authorization: Bearer wmr_live_xxxxxxxxxxxxxxxx

→ {"valid": true, "status": "active", "end_reason": null, "married_year": "2021", "ended": null}

Errors

Code	Meaning
400	country, nid or purpose missing
401	missing or invalid key
403	key not allowed for that country
429	daily limit reached

To request a key, contact the registrar through the government partnership page. Government partnership →