API de verificación para organismos
Para gobiernos, embajadas, tribunales, migración y bancos que necesitan consultar el estado civil desde sus propios sistemas (solicitudes de visado, oficinas de registro matrimonial, KYC). Las claves solo las emite el registrador de WMR.
Consultar estado por documento nacional
GET https://worldmarriageregistry.com/api/v1/status?country=BD&nid=1988331000002&purpose=Visa%20application%20123 Authorization: Bearer wmr_live_xxxxxxxxxxxxxxxx
Respuesta:
{
"registered": true,
"married": true,
"active_marriages": 1,
"ended_marriages": 1,
"married_since": "2021",
"checked_at": "2026-11-15 06:30:00 UTC"
}
- El parámetro purpose es obligatorio y se guarda en el registro.
- Nunca se devuelve nombre, foto, dirección, cónyuge ni documento.
- La persona puede ver en su cuenta qué organización la consultó y cuándo.
- Las claves nacionales solo pueden consultar su propio país. Hay límites diarios (HTTP 429).
Verificar un certificado
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}
Errores
| Código | Significado |
|---|---|
| 400 | falta country, nid o purpose |
| 401 | clave ausente o no válida |
| 403 | clave no permitida para ese país |
| 429 | límite diario alcanzado |
Para solicitar una clave, contacte al registrador desde la página de colaboración con gobiernos. Colaboración con gobiernos →