Superfinanciera Doctrine Search

Search the Superintendencia Financiera de Colombia's doctrine and case-law catalog: every concepto it has issued since 1994 (the Superintendencia Bancaria's before 2005), every ruling of its Delegatura para Funciones Jurisdiccionales, and the high-court rulings it catalogues as jurisprudencia financiera. Free text matches the number, case file number, title, summary, subject descriptors and full text. Filter by collection, year, number, registration_number (expediente or radicado), issuer, topic, the date (from_date/to_date) and text_status. Each result links to its entry in the Superintendencia's catalog and to the document. Served by Croma (as_of says how current the data is).

Dataset endpoint: answers from the whole source in milliseconds and carries as_of.

post/co/superfinanciera-doctrine/search/v1

Request

Base URL: https://api.croma.run
URL: https://api.croma.run/co/superfinanciera-doctrine/search/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

querystring

Optional search terms matched against the document's number, case file number, title, summary, topics and full text.

collection'any' | 'concept' | 'jurisdictional_ruling' | 'financial_case_law' | 'other'

Part of the catalog: concept (conceptos, the SFC's doctrine), jurisdictional_ruling (fallos of its Delegatura para Funciones Jurisdiccionales), financial_case_law (high-court sentencias the SFC catalogues as jurisprudencia financiera), other, or any.

yearinteger

Optional year the SFC files the document under (the year it was issued, in almost every case). 0 searches every year.

numberstring

Optional number of the concepto, fallo or sentencia as the SFC prints it (2020311455-001, 2017-1900, T-123). Case, spaces and leading zeros are ignored.

registration_numberstring

Optional case file number (expediente or radicado) of a fallo or sentencia, e.g. 2019123456. Case, spaces and punctuation are ignored.

issuerstring

Optional issuer, matched from the start of the name: superintendencia financiera (its Delegatura para Funciones Jurisdiccionales included), superintendencia bancaria, corte constitucional, consejo de estado, corte suprema. Case and accents are ignored.

topicstring

Optional subject descriptor, as the SFC publishes it in topics, e.g. PROTECCIÓN AL CONSUMIDOR FINANCIERO. Case and accents are ignored.

from_datestring date

Optional date filter in yyyy-mm-dd format.

to_datestring date

Optional date filter in yyyy-mm-dd format.

Optional state of the document's text: extracted (the full text is here), no_text_layer (a scan or a format with no text to read), audio (a hearing published as a recording), dead_link (the SFC's link leads to no document), withdrawn, no_document, or any.

pageinteger

1-based page number for paginated results.

per_pageinteger

Results per page (1-50).

Response

Successful response

Changes

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