Superfinanciera Doctrina

El catálogo de doctrina y jurisprudencia de la biblioteca de la Superintendencia Financiera de Colombia, cerca de 19.000 documentos: cada concepto que ha emitido desde 1994 (los de la Superintendencia Bancaria antes de 2005), cada fallo de su Delegatura para Funciones Jurisdiccionales y las sentencias de la Corte Constitucional, el Consejo de Estado y la Corte Suprema de Justicia que cataloga como jurisprudencia financiera. Cada uno llega con el resumen y los descriptores de la propia SFC, su número, fecha, emisor y expediente, su texto completo cuando el documento tiene texto, y los enlaces a la entrada y al documento en la Superintendencia. Busca en todos a la vez, por colección, año, número, expediente, emisor, descriptor o fecha, o con texto libre que llega hasta el cuerpo de cada documento. Busca primero y luego lee un documento completo.

La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye as_of: qué tan actualizados están los datos. Cómo funcionan los datasets.

Buscar doctrina y jurisprudencia

POST /co/superfinanciera-doctrine/search/v1 Dataset Una sola búsqueda sobre el texto completo de todos los conceptos desde 1994 y todos los fallos jurisdiccionales de la Superintendencia, filtrada por colección, año, número, expediente, emisor, descriptor, fecha o estado del texto.

Campo	Tipo	Notas
`query`	string	Palabras opcionales que se buscan en el número del documento, el expediente, el título, el resumen, los descriptores y el texto completo.
`collection`	enum	`concept` (conceptos, la doctrina de la SFC), `jurisdictional_ruling` (fallos de su Delegatura para Funciones Jurisdiccionales), `financial_case_law` (sentencias de las altas cortes que cataloga como jurisprudencia financiera), `other` o `any`. Por defecto `any`.
`year`	integer	Año opcional bajo el que la SFC archiva el documento (el año en que se expidió, en casi todos los casos). 0 busca en todos los años. Por defecto `0`.
`number`	string	Número opcional, como lo imprime la SFC: `2020311455-001`, `2017-1900`, `T-123`. No importan mayúsculas, espacios ni ceros a la izquierda.
`registration_number`	string	Expediente o radicado opcional de un fallo o una sentencia. No importan mayúsculas, espacios ni signos.
`issuer`	string	Emisor opcional, desde el inicio del nombre: `superintendencia financiera` (incluida su Delegatura), `superintendencia bancaria`, `corte constitucional`, `consejo de estado`, `corte suprema`. No importan mayúsculas ni tildes.
`topic`	string	Descriptor opcional, como lo publica la SFC en `topics`, p. ej. `PROTECCIÓN AL CONSUMIDOR FINANCIERO`. No importan mayúsculas ni tildes.
`from_date`	string	Opcional: solo documentos con fecha igual o posterior, `yyyy-mm-dd`.
`to_date`	string	Opcional: solo documentos con fecha igual o anterior, `yyyy-mm-dd`.
`text_status`	enum	Opcional: `extracted` para los documentos cuyo texto completo está aquí, o `no_text_layer`, `audio`, `dead_link`, `withdrawn`, `no_document` o `any`. Por defecto `any`.
`page`	integer	Número de página, empieza en 1. Por defecto `1`.
`per_page`	integer	Resultados por página (1-50). Por defecto `20`.

curl https://api.croma.run/co/superfinanciera-doctrine/search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "consumidor financiero", "collection": "concept" }'

Devuelve as_of (qué tan actualizados están los datos), los filtros aplicados, total (coincidencias en todas las páginas), page, per_page, total_pages, count y results[], del más reciente al más antiguo. Cada resultado incluye id (el identificador del documento en el catálogo de la Superintendencia), collection (concept, jurisdictional_ruling, financial_case_law u other), type (Concepto, Fallo o Sentencia), number y number_key, registration_number y registration_key (el expediente o radicado), year, issued_at, title, subject, summary (el resumen de la propia SFC), topics[] y topic_keys[], issuer e issuer_key, reporting_judges[] (el ponente de una sentencia), series, notes, withdrawn_at, text_status, document_format, official_url (la entrada en el catálogo de la Superintendencia) y document_url (el documento mismo).

text_status indica si el texto completo del documento está aquí: extracted (sí), no_text_layer (el documento es un escaneo, o está en un formato sin texto que leer), audio (una audiencia que la SFC publicó como grabación, como hizo con la mayoría de los fallos proferidos en audiencia), dead_link (el enlace de la SFC no lleva a un documento), withdrawn o no_document. Todas las entradas están aquí sea cual sea su estado, con official_url y, cuando lo hay, document_url.

Los resultados de búsqueda no incluyen el texto del documento, que llega a decenas de miles de caracteres. query sí busca dentro de él, así que una frase del cuerpo encuentra el documento; para leer el texto usa el endpoint Superfinanciera Doctrine Entry.

Un documento, completo

POST /co/superfinanciera-doctrine/entry/v1 Dataset

Campo	Tipo	Notas
`entry_id`	string	Obligatorio. El `id` de los resultados de búsqueda, p. ej. `18717`.
`offset`	integer	Primer carácter del texto a devolver. Envía el `next_offset` de la respuesta anterior para seguir leyendo. Por defecto `0`.
`limit`	integer	Cuántos caracteres del texto devolver. La mayoría de los documentos caben en una sola respuesta. Por defecto `200000`.

curl https://api.croma.run/co/superfinanciera-doctrine/entry/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "entry_id": "1" }'

Devuelve as_of, found, entry_id y entry, que trae todo lo que devuelve la búsqueda más content: una ventana sobre el texto completo del documento, con text, offset, total_length, has_more y next_offset. content es null salvo que text_status sea extracted. Cada resultado incluye id (el identificador del documento en el catálogo de la Superintendencia), collection (concept, jurisdictional_ruling, financial_case_law u other), type (Concepto, Fallo o Sentencia), number y number_key, registration_number y registration_key (el expediente o radicado), year, issued_at, title, subject, summary (el resumen de la propia SFC), topics[] y topic_keys[], issuer e issuer_key, reporting_judges[] (el ponente de una sentencia), series, notes, withdrawn_at, text_status, document_format, official_url (la entrada en el catálogo de la Superintendencia) y document_url (el documento mismo).

Los fallos largos llegan a cientos de miles de caracteres, así que el texto se lee por rangos: envía offset y limit, y luego pasa el next_offset de la respuesta como offset hasta que has_more sea falso.

Un id que el catálogo no contiene devuelve found: false con HTTP 200, no un error.

Referencia completa

Esquemas, todos los campos de respuesta y un playground interactivo.

Primeros pasos

Tipos de solicitud

Países

Superfinanciera Doctrina

Buscar doctrina y jurisprudencia

Un documento, completo

Referencia completa

​Buscar doctrina y jurisprudencia

​Un documento, completo

Referencia completa

Buscar doctrina y jurisprudencia

Un documento, completo