API de verificação para órgãos
Para governos, embaixadas, tribunais, imigração e bancos que precisam consultar o estado civil a partir dos próprios sistemas (pedidos de visto, cartórios de casamento, KYC). As chaves são emitidas apenas pelo registrador do WMR.
Consultar status pelo documento nacional
GET https://worldmarriageregistry.com/api/v1/status?country=BD&nid=1988331000002&purpose=Visa%20application%20123 Authorization: Bearer wmr_live_xxxxxxxxxxxxxxxx
Resposta:
{
"registered": true,
"married": true,
"active_marriages": 1,
"ended_marriages": 1,
"married_since": "2021",
"checked_at": "2026-11-15 06:30:00 UTC"
}
- O parâmetro purpose é obrigatório e fica no registro.
- Nenhum nome, foto, endereço, cônjuge ou documento é devolvido.
- A pessoa vê em sua conta qual organização a consultou e quando.
- Chaves nacionais só consultam o próprio país. Há limites diários (HTTP 429).
Verificar uma certidão
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}
Erros
| Código | Significado |
|---|---|
| 400 | country, nid ou purpose ausente |
| 401 | chave ausente ou inválida |
| 403 | chave não permitida para esse país |
| 429 | limite diário atingido |
Para pedir uma chave, contate o registrador pela página de parceria com governos. Parceria com governos →