콜롬비아 — 결혼 민사등록 (SCCRC)

Registraduría Nacional del Estado Civil(SCCRC)의 결혼 민사등록부(registro civil de matrimonio)를 조회합니다.

검색 모드는 하나만 제공하세요.

1. documentNumber + sexo — 문서 검색(단일 기록)
2. primerNombre + primerApellido + sexo + fecha — 이름 검색(matches 반환 가능)
3. serial — 일련번호 검색(단일 기록)

이 API가 반환하는 내용

• 단일 기록 또는 matches 배열(이름 모드)
• documentNumber, documentType, 이름, sexo, serial
• 가능할 때 oficina / expeditionPlace, fecha
• recordType — REGISTRO CIVIL DE MATRIMONIO
• 서명된 Verifik 응답 래퍼

API 레퍼런스

엔드포인트

GET https://api.verifik.co/v2/co/registraduria/matrimonio

결혼 등록 조회에 이 엔드포인트를 사용합니다. 동일한 연동은 JSON 본문의 **POST**로도 가능합니다. **GET**은 아래와 같이 쿼리 매개변수를 사용합니다.

헤더(Headers)

Name	Value
Accept	application/json
Authorization	Bearer <token>

매개변수(Parameters)

name	type	required	description	Examples
documentNumber	string	conditional	NUIP/CC; sexo 필요	10000001
sexo	string	conditional	문서 또는 이름 검색에 필요 (MASCULINO / FEMENINO)	MASCULINO
serial	string	conditional	결혼 등록 일련번호	0042012345
primerNombre	string	conditional	첫 번째 이름(이름 모드)	JUAN
primerApellido	string	conditional	첫 번째 성(이름 모드)	PEREZ
fecha	string	conditional	결혼일 DD/MM/YYYY(이름 모드)	20/06/2015
segundoNombre	string	no	두 번째 이름	CARLOS
segundoApellido	string	no	두 번째 성	GOMEZ

요청(Request)

JavaScript

import axios from "axios";

const { data } = await axios.get("https://api.verifik.co/v2/co/registraduria/matrimonio", {
	params: {
		documentNumber: "10000001",
		sexo: "MASCULINO",
	},
	headers: {
		Accept: "application/json",
		Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
	},
});
console.log(data);

Python

import os, requests

url = "https://api.verifik.co/v2/co/registraduria/matrimonio"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentNumber": "10000001", "sexo": "MASCULINO"}
r = requests.get(url, headers=headers, params=params)
print(r.json())

응답(Response)

200

{
	"data": {
		"documentType": "CC",
		"documentNumber": "10000001",
		"firstName": "JUAN CARLOS",
		"lastName": "PEREZ GOMEZ",
		"fullName": "JUAN CARLOS PEREZ GOMEZ",
		"arrayName": ["JUAN", "CARLOS", "PEREZ", "GOMEZ"],
		"sexo": "MASCULINO",
		"serial": "0042012345",
		"oficina": "NOTARIA UNICA - BOGOTA D.C.",
		"fecha": "20/06/2015",
		"recordType": "REGISTRO CIVIL DE MATRIMONIO"
	},
	"signature": {
		"dateTime": "July 20, 2026 12:00 PM",
		"message": "Certified by Verifik.co"
	}
}

404

{
	"code": "NotFound",
	"message": "Record not found."
}

409

{
	"code": "MissingParameter",
	"message": "Provide serial, or documentNumber+sexo, or name fields with sexo and fecha"
}

기능

• 세 가지 검색 모드: 문서, 이름, 또는 일련번호
• 이름 모드는 **matches**를 반환할 수 있음; 문서/일련번호는 단일 객체 반환
• GET과 POST가 동일한 핸들러를 공유

사용 사례

• KYC / 컴플라이언스를 위한 결혼 등록 일치 확인
• 알려진 문서에 연결된 결혼 일련번호 해석
• 생체정보만 있을 때 이름 기반 스크리닝

참고(Notes)

• 검색 모드는 정확히 하나만 제공하세요(일련번호를 문서/이름 필드와 섞지 마세요).
• 샌드박스: 문서 번호 10000001–10000010; 이름 모드는 이름으로 조회와 동일한 샌드박스 프로필을 따릅니다.
• 일시적인 소스 가용성 문제는 409(Endpoint_out_of_service)로 나타날 수 있습니다.
• 관련: 문서로 시민 조회, 이름으로 시민 조회, 일련번호로 민사등록 조회, Registraduría 증명서.