API xác minh cho cơ quan

OpenAPI 3 (JSON) →

Dành cho chính phủ, đại sứ quán, tòa án, cơ quan xuất nhập cảnh và ngân hàng cần tra cứu tình trạng hôn nhân từ hệ thống của mình (hồ sơ thị thực, phòng đăng ký kết hôn, KYC). Khóa chỉ do cán bộ đăng ký WMR cấp.

Tra cứu tình trạng bằng số định danh quốc gia

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

Phản hồi:

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

Tham số purpose là bắt buộc và được lưu vào nhật ký.
Không bao giờ trả về tên, ảnh, địa chỉ, vợ/chồng hay giấy tờ.
Người đó có thể xem trong tài khoản của mình tổ chức nào đã tra cứu và khi nào.
Khóa quốc gia chỉ tra cứu được nước mình. Có giới hạn mỗi ngày (HTTP 429).

Kiểm tra giấy chứng nhận

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}

Lỗi

Mã	Ý nghĩa
400	thiếu country, nid hoặc purpose
401	thiếu khóa hoặc khóa không hợp lệ
403	khóa không được phép cho quốc gia đó
429	đã đạt giới hạn mỗi ngày

Để xin khóa, hãy liên hệ cán bộ đăng ký qua trang hợp tác với chính phủ. Hợp tác với chính phủ →