코스타리카 - 투표 장소

Verifik는 TSE Donde Votar 선거 등록부에서 CCCR(코스타리카 cédula, 9~13자리)로 조회합니다. 코스타리카 선거 데이터가 허용되는 선거 검증, 유권자 온보딩, 컴플라이언스 워크플로에 사용하세요.

소스에서 제공할 때 선거 장소 세부 정보를 반환합니다:

• documentType — 허용 값: CCCR
• documentNumber — 코스타리카 cédula (9~13자리)
• fullName, firstName, firstLastName, secondLastName — 선거 등록부의 시민 이름
• gender — 소스에서 제공하는 경우 성별 코드
• province, canton, district — 거주지 및 선거 지리
• pollingPlace, pollingTable — 투표 장소 세부 정보
• electoralCode, electorNumber, schoolAddress — TSE junta 메타데이터
• 선택 필드 — 소스에 포함된 경우 latitude, longitude
• Verifik 서명 응답

Endpoint

GET v2/cr/votacion

documentType CCCR과 9~13자리 **documentNumber**로 TSE Donde Votar 등록부를 조회합니다. 성공 응답에는 KYC, 선거 검증, 컴플라이언스 워크플로에 필요한 투표소, junta(테이블), province, canton, district가 포함됩니다.

Headers

Header	Value	Description
Accept	application/json	응답 형식
Authorization	Bearer <token>	Verifik JWT

Parameters

Field	Type	Required	Description	Example
documentType	String	Yes	문서 유형. 허용 값: CCCR.	CCCR
documentNumber	String	Yes	코스타리카 cédula (9~13자리).	401310036

Request

JavaScript

const { data } = await axios.get("https://api.verifik.co/v2/cr/votacion", {
  params: {
    documentType: "CCCR",
    documentNumber: "401310036",
  },
  headers: {
    Accept: "application/json",
    Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
  },
});
console.log(data);

Python

url = "https://api.verifik.co/v2/cr/votacion"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentType": "CCCR", "documentNumber": "401310036"}
r = requests.get(url, headers=headers, params=params)
print(r.json())

Response

200

{
  "data": {
    "documentType": "CCCR",
    "documentNumber": "401310036",
    "fullName": "MARIA ELENA LOPEZ GARCIA",
    "firstName": "MARIA",
    "firstLastName": "LOPEZ",
    "secondLastName": "GARCIA",
    "gender": "1",
    "province": "San José",
    "canton": "Central",
    "district": "Carmen",
    "pollingPlace": "Escuela República de Chile",
    "pollingTable": "12",
    "electoralCode": "210011",
    "electorNumber": "325",
    "schoolAddress": "COSTADO NORTE DE LA PLAZA DE DEPORTES",
    "latitude": 9.9281,
    "longitude": -84.0907
  },
  "signature": {
    "dateTime": "July 13, 2026 5:00 PM",
    "message": "Certified by Verifik.co"
  }
}

404

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

409

{
  "code": "MissingParameter",
  "message": "missing documentNumber\n"
}

Notes

• **documentType**는 **CCCR**이어야 하며, **documentNumber**는 9~13자리 숫자여야 합니다.
• 프로덕션 예시 ID: 401310036, 401310030, 401310039, 402330708, 114070037.
• 샌드박스 모드: 안정적인 성공 프로필에는 010000001~010000010 테스트 ID를 사용하세요. **090040401**은 404를 반환합니다.
• 응답을 민감한 개인 데이터로 취급하고 해당 개인정보 보호법을 준수하세요.
• 참고: 🇨🇷 코스타리카 국민(CCCR).