Buscar la normativa
POST /co/superfinanciera/regulations-search/v1 Una sola búsqueda sobre circulares externas, cartas circulares y resoluciones desde 2005 hasta hoy, algo que el sitio de la Superintendencia no ofrece.
La fuente entera, organizada y lista para consultar: este endpoint responde en milisegundos, a cualquier hora y siempre igual. Cada respuesta incluye
as_of: qué tan actualizados están los datos.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, kind, number tal como lo imprime la
normativa, number_key (el mismo número sin ceros a la izquierda), year,
issued_at, title (cómo se cita el acto), description (lo que hace el acto,
en palabras de la propia Superintendencia), bulletin (el número del Boletín del
Ministerio de Hacienda y Crédito Público en que se publicó), document_url,
attachments[] y official_url.
Toda la normativa, de 2005 a los actos de esta semana, lista para consultar. Los
actos siguen donde los publica la Superintendencia:
document_url es la
dirección para leer uno, y el formato del archivo depende de la época en que se
expidió.Un acto
POST /co/superfinanciera/regulation/v1
La fuente entera, organizada y lista para consultar: este endpoint responde en milisegundos, a cualquier hora y siempre igual. Cada respuesta incluye
as_of: qué tan actualizados están los datos.as_of, found, regulation_id y regulation. Cada resultado incluye id, kind, number tal como lo imprime la
normativa, number_key (el mismo número sin ceros a la izquierda), year,
issued_at, title (cómo se cita el acto), description (lo que hace el acto,
en palabras de la propia Superintendencia), bulletin (el número del Boletín del
Ministerio de Hacienda y Crédito Público en que se publicó), document_url,
attachments[] y official_url.
Un id que la normativa no contiene devuelve
found: false con HTTP 200, no un
error.Solicitud
POST /co/superfinanciera/complaints/v1
Respuesta
actions es el historial de actuaciones de la demanda, una entrada por paso
(de la más antigua a la más reciente). Una radicación sin demandas devuelve un
arreglo vacío.
Esta búsqueda puede tardar más que una solicitud típica. Es un
trabajo asíncrono. Por defecto la solicitud espera en línea y
devuelve
{ data }, o puedes hacer polling / usar un callback_url. Si no hay
coincidencias devuelve un arreglo actions vacío, no un error.Referencia completa
Esquemas, todos los campos de respuesta y un playground interactivo.