기관용 검증 API
자체 시스템에서 혼인 상태를 확인해야 하는 정부, 대사관, 법원, 출입국 기관, 은행용입니다(비자 신청, 혼인 등록 사무소, 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 | 일일 한도 도달 |
키를 요청하려면 정부 협력 페이지를 통해 등록관에게 연락하세요. 정부 협력 →