DNP Social Classification (Sisbén IV and RUI)

Look up a person's socioeconomic classification in Colombia by document, live from the DNP: the Sisbén IV group (A1 to D21, with its category and label) and the RUI income classification with the registered name, sex, age and municipality. document_type defaults to CC. Returns found: false when the person has neither.

post/co/dnp/social-classification/v1

Request

Base URL: https://api.croma.run
URL: https://api.croma.run/co/dnp/social-classification/v1
Auth: HTTP bearer

Headers

Idempotency-Keystring

Example:0f8e9a42-6b7c-4d1e-9a3f-2c5d7e8f9a0b

Optional client-chosen key for this request (any string up to 255 characters, e.g. a UUID). Every Croma operation is an idempotent lookup: repeating a request with the same body returns the same result and creates nothing, so retrying after a timeout or network failure is always safe. The key is echoed back in the Idempotency-Key response header so you can correlate a retry with its first attempt. Each attempt that reaches the API counts against the rate limit.

Request body

document_type'CC' | 'TI' | 'CE' | 'RC' | 'PA' | 'PEP' | 'PPT'

Colombian document type. Defaults to CC.

document_numberstring required

Document number (alphanumeric with hyphens allowed).

Response

Successful response

Changes

No recorded changes to this operation across all 1 revision of this API.