API di verifica per enti

OpenAPI 3 (JSON) →

Per governi, ambasciate, tribunali, immigrazione e banche che devono verificare lo stato civile dai propri sistemi (domande di visto, uffici di stato civile, KYC). Le chiavi sono rilasciate solo dall'ufficiale WMR.

Verifica lo stato con il documento nazionale

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

Risposta:

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

Il parametro purpose è obbligatorio e viene registrato.
Non vengono mai restituiti nome, foto, indirizzo, coniuge o documenti.
La persona vede nel proprio account quale organizzazione l'ha verificata e quando.
Le chiavi nazionali verificano solo il proprio paese. Si applicano limiti giornalieri (HTTP 429).

Verifica un certificato

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}

Errori

Codice	Significato
400	manca country, nid o purpose
401	chiave mancante o non valida
403	chiave non consentita per quel paese
429	limite giornaliero raggiunto

Per richiedere una chiave contatta l'ufficiale dalla pagina di partnership con i governi. Partnership con i governi →