機関向け照会API
自らのシステムから婚姻状況を照会する必要がある政府・大使館・裁判所・入国管理・銀行向け(ビザ申請、婚姻登録窓口、KYC)。キーはWMR登録官のみが発行します。
国民IDで状況を照会
GET https://worldmarriageregistry.com/api/v1/status?country=BD&nid=1988331000002&purpose=Visa%20application%20123 Authorization: Bearer wmr_live_xxxxxxxxxxxxxxxx
レスポンス:
{
"registered": true,
"married": true,
"active_marriages": 1,
"ended_marriages": 1,
"married_since": "2021",
"checked_at": "2026-11-15 06:30:00 UTC"
}
- purpose パラメーターは必須で、ログに保存されます。
- 氏名・写真・住所・配偶者・書類は一切返されません。
- 本人は自分のアカウントで、どの組織がいつ照会したかを確認できます。
- 国内キーは自国のみ照会できます。1日の上限があります(HTTP 429)。
証明書を確認
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}
エラー
| コード | 意味 |
|---|---|
| 400 | country・nid・purpose が不足 |
| 401 | キーがないか無効 |
| 403 | この国ではキーが許可されていない |
| 429 | 1日の上限に到達 |
キーを申請するには、政府連携ページから登録官に連絡してください。 政府との連携 →