API استعلام برای نهادها

OpenAPI 3 (JSON) →

برای دولت‌ها، سفارت‌ها، دادگاه‌ها، اداره مهاجرت و بانک‌هایی که باید وضعیت تأهل را از سامانه خود بررسی کنند (درخواست ویزا، دفاتر ثبت ازدواج، KYC). کلیدها فقط توسط ثبت‌کننده WMR صادر می‌شوند.

بررسی وضعیت با شناسه ملی

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 الزامی است و در گزارش ذخیره می‌شود.
هرگز نام، عکس، نشانی، همسر یا مدرکی بازگردانده نمی‌شود.
فرد می‌تواند در حساب خود ببیند کدام سازمان و چه زمانی او را بررسی کرده است.
کلیدهای ملی فقط کشور خود را بررسی می‌کنند. سقف روزانه اعمال می‌شود (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	سقف روزانه پر شد

برای دریافت کلید از طریق صفحه همکاری دولتی با ثبت‌کننده تماس بگیرید. همکاری دولتی ←