Colombia — SISBEN score

Endpoint

GET https://api.verifik.co/v2/co/sisben

Returns SISBEN group / score information from the official consultation portal using the person’s documentType and documentNumber. Data may include group label, survey validity, municipality, department, and related metadata. This endpoint uses browser automation against the public SISBEN report site; responses can be slower than typical REST calls.

Headers

Name	Value
Accept	application/json
Authorization	Bearer <token>

Parameters

name	type	required	description
documentType	string	yes	One of CC, CE, PEP, PPT, PA.
documentNumber	string	yes	ID number without spaces or punctuation.

Request

JavaScript

import axios from "axios";

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

Python

import os, requests

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

Response

200

{
	"data": {
		"arrayName": ["APELLIDO", "NOMBRE", "SEGUNDO"],
		"city": "BOGOTÁ D.C.",
		"currentSurvey": "…",
		"department": "CUNDINAMARCA",
		"detaliGroup": "…",
		"documentNumber": "1121329661",
		"documentType": "CC",
		"file": "…",
		"firstName": "NOMBRE SEGUNDO",
		"fullName": "NOMBRE SEGUNDO APELLIDO",
		"lastCitizenUpdate": "…",
		"lastName": "APELLIDO",
		"sisbenGroup": "A",
		"validity": "…"
	},
	"signature": {
		"dateTime": "April 8, 2026 11:00 PM",
		"message": "Certified by Verifik.co"
	},
	"id": "IDNT1"
}

404

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

409

{
	"code": "MissingParameter",
	"message": "documentType must be one of: [CC,CE,PEP,PPT,PA]"
}

Features

• Group / score: SISBEN group and related labels returned when the portal shows a result.
• Location fields: Municipality and department when parsed from the report.
• Survey metadata: Current survey and last update lines when available.

Use cases

• Social programs: Eligibility checks tied to SISBEN classification.
• KYCC / onboarding: Validate beneficiary status where regulations allow use of official consultation data.

Notes

• Requests may take several seconds because the integration drives the public web consultation.
• PPT is accepted by API validation; if the upstream form mapping changes, you may see 500 errors until the integration is updated.