Colombia Rama Judicial Court Records Scraper (Procesos)

Scrape Colombian court records from the Rama Judicial Consulta de Procesos Nacional Unificada (CPNU) by company name, person name (nombre), or exact radicado. A consulta de procesos rama judicial and Colombia court records API in one actor, built for legal due diligence, KYB, and litigation search. Here is one real result, with every field the actor returns (the actuaciones array holds 7 movements; 2 are shown here, all values real):

{
  "radicado": "13001310300320170056402",
  "despacho": "DESPACHO 000 - TRIBUNAL SUPERIOR - CIVIL - FAMILIA - CARTAGENA *",
  "processType": "Sin Tipo de Proceso",
  "processClass": "Sin Tipo de Proceso",
  "subClass": "Sin Subclase de Proceso",
  "recurso": "Sin Tipo de Recurso",
  "ponente": "MAG. JOHN FREDDY SAZA PINEDA",
  "ubicacion": "Secretaria",
  "courtCode": "130012213000",
  "contenidoRadicacion": "3C: 200,201-400,401-649 VERBAL REIVINDICATORIO EN APELACIÒN DE AUTO",
  "department": "BOLÍVAR",
  "cityCode": "13001",
  "filingYear": 2017,
  "demandantes": ["GRUPO ARGOS S.A."],
  "demandados": ["WALFREDO PACHECO HERNANDEZ", "EDGARDO PACHECO POLO", "NARCILA PACHECO DE GUERRERO", "JUAN ANDRES PACHECO", "BONIFACIO PACHECO DE LA ROSA"],
  "otrosSujetos": [],
  "sujetosProcesales": [
    {"name": "GRUPO ARGOS S.A.", "role": "demandante", "roleLabel": "Demandante", "docType": null, "docNumber": null},
    {"name": "WALFREDO PACHECO HERNANDEZ", "role": "demandado", "roleLabel": "Demandado", "docType": null, "docNumber": null}
  ],
  "sujetosCount": 6,
  "partiesRaw": "Demandante: GRUPO ARGOS S.A. | Demandado: WALFREDO PACHECO HERNANDEZ | Demandado: EDGARDO PACHECO POLO | Demandado: NARCILA PACHECO DE GUERRERO | Demandado: JUAN ANDRES PACHECO | Demandado: BONIFACIO PACHECO DE LA ROSA",
  "filingDate": "2019-08-27",
  "lastActionDate": "2019-12-18",
  "lastActionDaysAgo": 2443,
  "lastUpdate": "2026-08-05",
  "isPrivate": false,
  "idProceso": 59607293,
  "url": "https://consultaprocesos.ramajudicial.gov.co",
  "actuacionesCount": 7,
  "actuaciones": [
    {"consecutivo": 7, "actuacion": "Auto decide recurso", "anotacion": "CONFIRMA AUTO DE 30 DE AGOSTO DE 2019", "date": "2019-12-18", "startDate": null, "endDate": null, "registeredDate": "2019-12-18", "hasDocuments": false},
    {"consecutivo": 1, "actuacion": "Reparto y Radicación", "anotacion": "REPARTO Y RADICACION DEL PROCESO REALIZADAS EL martes, 27 de agosto de 2019 con secuencia: 12599", "date": "2019-08-27", "startDate": null, "endDate": null, "registeredDate": "2019-08-27", "hasDocuments": false}
  ],
  "observedAt": "2026-08-26T12:28:20.980Z",
  "error": null
}

The most complete Colombia Rama Judicial scraper available, and the only one on the Apify Store. It returns every field the Consulta de Procesos platform exposes for each judicial process, from the court, judge, parties, and process classification to the full timeline of actuaciones (case movements), plus derived fields (filing year, city and court codes, days since last action, party count) and 11 filters to target exactly the cases you need. Optional AI add-ons summarize, translate, and extract structured data from each case.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• How we compare
• Use cases
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

This is a Rama Judicial scraper and consulta de procesos Colombia API in one actor. It searches the Colombian judiciary's Consulta de Procesos Nacional Unificada (CPNU) platform by company or person name, or by exact radicado (23-digit process number), and writes one normalized record per judicial process to the run's dataset. Each record carries the radicado, court (despacho) with its full and city-level codes, process type, class and subclass, reporting magistrate (ponente), department, and the parties (plaintiffs, defendants, other subjects) as arrays, as a structured sujetosProcesales list with roles, and as a raw string. With details on, it also returns the full timeline of actuaciones (case movements) with dates, notes, and start/end dates. Missing source values are returned as null, never invented.

Eleven input filters let you target exactly the cases you want: party type, court/city code, party role (plaintiff or defendant), one or more departments, filing date range, and last-action date, plus toggles to include or skip details and movements for speed. Three optional paid AI add-ons layer on top: a plain-language Spanish summary, an English translation and summary, and structured extraction of the case (claim type, court, amounts). Each is charged only when it produces usable output.

How we compare

There is currently no other Colombia Rama Judicial or Colombian court-records scraper on the Apify Store, so on Apify this is the only turnkey option. The real alternatives are a few standalone Colombian commercial APIs and web portals (for example apitude.co, coresoft.solutions, NBI, expedientes.co) and generic US-court scrapers (PACER, RECAP, CourtListener) that do not cover Colombia at all.

Capability	This actor	Typical Colombian court API/portal	US court scrapers (PACER / CourtListener)
Colombia Rama Judicial coverage	Yes, nationwide (CPNU)	Yes	No
Search by company / person name	Yes (batch, many per run)	Usually one at a time	N/A
Search by exact radicado	Yes (batch)	Yes	N/A
Full actuaciones (movement) timeline	Yes, with dates and notes	Rarely	N/A
Structured parties with roles	Yes (sujetosProcesales)	Partial	N/A
Filters (role, department, date range, active)	Yes, 11 inputs	Minimal	N/A
Derived fields (filing year, codes, days-since-action)	Yes	No	N/A
Bulk multi-search in one run	Yes	No	N/A
Export to JSON, CSV, Excel	Yes	Varies	Yes
Pay per result, no charge on failure	Yes	Contact-sales pricing	Varies

Why choose this actor: you get the full case surface (parties, classification, and every movement) in one call, bulk multi-name and multi-radicado search, filters no portal offers, and transparent pay-per-result billing with no charge on empty or failed runs.

Use cases

• Legal due diligence and KYB in Colombia. Pull the litigation history of a company (razón social) before onboarding, investing, or signing, and see plaintiffs, defendants, courts, and case status.
• Litigation risk and background checks. Screen counterparties, suppliers, or individuals for active and past court processes across all Colombian departments.
• Law-firm case monitoring. Track your own or opposing parties' dockets and watch new actuaciones (movements) by filtering on last-action date.
• Debt collection and recovery. Find judicial processes tied to a debtor and follow their procedural stage.
• Compliance, AML, and vendor screening. Add Colombian court-record checks to onboarding and periodic review workflows.
• Journalism and investigations. Research litigation involving public companies, officials, or organizations, with the full movement history.

Quickstart

Open the actor, paste this into the input, and press Run. It returns up to 10 judicial processes for a company, with the full actuaciones timeline.

{
  "searchNames": ["GRUPO ARGOS S.A."],
  "tipoPersona": "jur",
  "maxRecords": 10,
  "withDetails": true,
  "withActuaciones": true,
  "onlyActive": false
}

Search by name with searchNames (set tipoPersona to jur for a company or nat for a person), or look up exact processes with radicados. A broad company name can match more than a thousand processes; narrow it with despacho (a court or city code prefix) or the role, departments, and date-range filters. For a faster metadata-only run, set withActuaciones to false.

Input reference

Field	Type	Required	Default	Description
searchNames	string[]	no	["GRUPO ARGOS S.A."]	Company names (razón social) or person names to search. Batch: one search per name.
radicados	string[]	no	(empty)	Exact 23-digit radicado (process number) to look up directly. Batch.
tipoPersona	enum	no	jur	Whether the searched name is a legal entity (jur) or a natural person (nat).
despacho	string	no	(empty)	Optional court or city code prefix to narrow a name search at the source, for example 11001 for Bogotá.
onlyActive	boolean	no	false	When on, keep only processes flagged active by the source.
role	enum	no	any	Keep only cases where the searched name is demandante (plaintiff) or demandado (defendant). any keeps all.
departments	string[]	no	(empty)	Keep only cases whose department matches one of these values (contains, case-insensitive), for example ANTIOQUIA.
filedFrom	string	no	(empty)	Keep only cases filed on or after this date (YYYY-MM-DD).
filedTo	string	no	(empty)	Keep only cases filed on or before this date (YYYY-MM-DD).
lastActionFrom	string	no	(empty)	Keep only cases whose last action was on or after this date (YYYY-MM-DD).
withDetails	boolean	no	true	When on, fetch the detail page (type, class, ponente, court code, location). Adds the details event per process.
withActuaciones	boolean	no	true	When on (and details on), fetch the full actuaciones timeline. Turn off to skip movement pagination for a faster run.
maxRecords	integer	no	10	Maximum number of court process records across all searches. Free Apify plans are capped at 10.
withSummary	boolean	no	false	Paid AI add-on. Plain-language Spanish summary of the case. Charged only on usable AI output. Requires a paid Apify plan.
withTranslate	boolean	no	false	Paid AI add-on. Clear English translation and summary of the case. Charged only on usable AI output. Requires a paid Apify plan.
withExtract	boolean	no	false	Paid AI add-on. Extract structured case data (claim type, court, amounts). Charged only on usable AI output. Requires a paid Apify plan.

The role, departments, filedFrom, filedTo, and lastActionFrom filters are applied to the returned records; cases filtered out are never charged. despacho, onlyActive, and tipoPersona are applied at the source.

Output reference

One dataset item per judicial process. Types: string, integer, boolean, string[], object[], or null when the source value is absent.

Field	Type	Description
radicado	string	23-digit process number (unique per process).
despacho	string	Court or office handling the process.
courtCode	string	Full court code (codDespachoCompleto). Present with details on.
cityCode	string	City / court prefix (first 5 digits of the radicado).
filingYear	integer	Year the process was filed, derived from the radicado or filing date.
processType	string	Process type (tipo de proceso).
processClass	string	Process class (clase de proceso).
subClass	string	Process subclass (subclase).
recurso	string	Type of appeal or recurso.
ponente	string	Reporting magistrate or judge.
ubicacion	string	Current physical location of the file.
contenidoRadicacion	string	Filing content description.
department	string	Department (region) of the court.
demandantes	string[]	Plaintiffs.
demandados	string[]	Defendants.
otrosSujetos	string[]	Other subjects and interveners. Empty array when none.
sujetosProcesales	object[]	Structured parties. Each has name, role (demandante/demandado/otro), roleLabel, docType, docNumber. Document numbers are not exposed by the source and are null.
sujetosCount	integer	Number of parties.
partiesRaw	string	All parties with their roles as a single raw string.
filingDate	string	Filing date (YYYY-MM-DD).
lastActionDate	string	Date of the last case movement (YYYY-MM-DD).
lastActionDaysAgo	integer	Whole days between the last action and the run date.
lastUpdate	string	Date the source last updated the record (YYYY-MM-DD). Present with details on.
isPrivate	boolean	true when the process is marked private.
idProceso	integer	Internal process ID on the platform (used for detail and movement lookups).
idConexion	integer	Jurisdiction connection ID of the source system.
idRegProceso	integer	Process registry ID from the detail page. Present with details on.
url	string	Rama Judicial consultation URL.
actuacionesCount	integer	Number of actuaciones (case movements).
actuaciones	object[]	Movement timeline. Each element has id, consecutivo, actuacion, anotacion, date, startDate, endDate, registeredDate, ruleCode, and hasDocuments. Present when details and movements are on.
aiSummary	string	AI plain-language Spanish summary, or null unless the add-on is enabled.
aiSummaryEn	string	AI English translation and summary, or null unless the add-on is enabled.
aiExtract	object	AI-extracted structured case data (claim type, court, amounts), or null unless enabled.
observedAt	string	ISO 8601 timestamp of when the record was collected.
error	string	null on success. On a failed or over-broad search, a single item with a populated error field is written instead, and it is not charged.

Example output record

Real record from a live run, input {"radicados": ["13001310300320170056402"], "withDetails": true, "withActuaciones": true}. Same process as the hero example, with the complete 7-movement actuaciones timeline:

{
  "radicado": "13001310300320170056402",
  "despacho": "DESPACHO 000 - TRIBUNAL SUPERIOR - CIVIL - FAMILIA - CARTAGENA *",
  "courtCode": "130012213000",
  "cityCode": "13001",
  "filingYear": 2017,
  "processType": "Sin Tipo de Proceso",
  "ponente": "MAG. JOHN FREDDY SAZA PINEDA",
  "ubicacion": "Secretaria",
  "department": "BOLÍVAR",
  "demandantes": ["GRUPO ARGOS S.A."],
  "demandados": ["WALFREDO PACHECO HERNANDEZ", "EDGARDO PACHECO POLO", "NARCILA PACHECO DE GUERRERO", "JUAN ANDRES PACHECO", "BONIFACIO PACHECO DE LA ROSA"],
  "sujetosCount": 6,
  "filingDate": "2019-08-27",
  "lastActionDate": "2019-12-18",
  "lastActionDaysAgo": 2443,
  "lastUpdate": "2026-08-05",
  "isPrivate": false,
  "idProceso": 59607293,
  "url": "https://consultaprocesos.ramajudicial.gov.co",
  "actuacionesCount": 7,
  "actuaciones": [
    {"consecutivo": 7, "actuacion": "Auto decide recurso", "anotacion": "CONFIRMA AUTO DE 30 DE AGOSTO DE 2019", "date": "2019-12-18", "startDate": null, "endDate": null, "registeredDate": "2019-12-18", "hasDocuments": false},
    {"consecutivo": 6, "actuacion": "Envío Expediente", "anotacion": "por medio de OFICIO No. 2737 DIRIGIDO A JUEZ TERCERO CIVIL DEL CIRCUITO DE CARTAGENA DEVOLVIENDO EXPEDIENTE DE 4 cuadernos con 38, 200, (201-400), (401-649) folios.", "date": "2019-10-16", "startDate": null, "endDate": null, "registeredDate": "2019-10-16", "hasDocuments": false},
    {"consecutivo": 5, "actuacion": "Fijacion estado", "anotacion": "Actuación registrada el 08/10/2019 a las 17:04:01.", "date": "2019-10-08", "startDate": null, "endDate": null, "registeredDate": "2019-10-08", "hasDocuments": false},
    {"consecutivo": 4, "actuacion": "Auto decide recurso", "anotacion": "SE CONFIRMA FALLO IMPUGNADO", "date": "2019-10-08", "startDate": null, "endDate": null, "registeredDate": "2019-10-08", "hasDocuments": false},
    {"consecutivo": 3, "actuacion": "Al despacho", "anotacion": "informando que se le dio cumplimiento a lo ordenado en el auto que le antecede y se recibió respuesta por parte del Juzgado Tercero Civil del Circuito de Cartagena.", "date": "2019-09-18", "startDate": null, "endDate": null, "registeredDate": "2019-09-18", "hasDocuments": false},
    {"consecutivo": 2, "actuacion": "Al despacho", "anotacion": "Rad. 2019-485-14", "date": "2019-08-28", "startDate": null, "endDate": null, "registeredDate": "2019-08-28", "hasDocuments": false},
    {"consecutivo": 1, "actuacion": "Reparto y Radicación", "anotacion": "REPARTO Y RADICACION DEL PROCESO REALIZADAS EL martes, 27 de agosto de 2019 con secuencia: 12599", "date": "2019-08-27", "startDate": null, "endDate": null, "registeredDate": "2019-08-27", "hasDocuments": false}
  ],
  "observedAt": "2026-08-26T12:28:20.980Z",
  "error": null
}

Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~colombia-rama-judicial-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchNames":["GRUPO ARGOS S.A."],"tipoPersona":"jur","despacho":"11001","withDetails":true,"maxRecords":10}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~colombia-rama-judicial-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"radicados":["13001310300320170056402"],"withDetails":true,"withActuaciones":true}'

Apify CLI:

apify call scrapers_lat/colombia-rama-judicial-scraper \
  --input '{"searchNames":["GRUPO ARGOS S.A."],"tipoPersona":"jur","role":"demandante","maxRecords":10}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> is returned as defaultDatasetId in the run object. Use offset and limit to page through large result sets. clean=true drops empty and internal fields.

Billing and limits

• Pay per result. You are charged per judicial process record returned (result event). See the pricing tab for the current per-result price.
• Details add-on. When withDetails is on, each process that is enriched with its detail page charges the details event. Turn it off for listing-only, lower-cost runs.
• Paid AI add-ons. ai_summary, ai_translate, and ai_extract are separate events, each billed only when they produce usable output. Leave them off to pay for results only.
• No charge on failure. If a run errors, a search is too broad, or a case is filtered out, the actor does not charge for it. Empty runs cost nothing.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further billable results.
• Free Apify plans are capped at 10 records per run, and paid AI add-ons are disabled. Upgrade for higher maxRecords and the AI add-ons.

FAQ and troubleshooting

What is a radicado? The radicado is the 23-digit numero de radicación that uniquely identifies a Colombian judicial process, for example 13001310300320170056402. Put one or more in radicados to look up exact cases.

My search returned an error about too many records. Why? A broad company name can match more than a thousand processes, and the platform then asks for more specific criteria. Narrow the search by adding a despacho court or city code prefix, or by role, department, and date filters, or look up exact radicados. That error record is not charged.

Can I search by cédula or NIT (document number)? The public Consulta de Procesos platform does not offer a document-number search endpoint, so this actor searches by name and by radicado. Party document numbers are not published by the source, so docType and docNumber are returned as null.

How do I find only recently active cases? Set lastActionFrom to a date, and optionally onlyActive on. Each record also includes lastActionDaysAgo so you can sort by recency.

Company or person: which tipoPersona? Use jur for a legal entity (company, razón social) and nat for a natural person.

Why is the actuaciones array empty or missing? Turn withDetails and withActuaciones on to fetch the detail page and the movement timeline. Some processes also have no registered movements yet.

Do the AI add-ons need a paid plan? Yes. The AI summary, translate, and extract add-ons require a paid Apify plan and are charged only when they return usable output.

How is this different from the free Rama Judicial consulta de procesos website? The official consulta de procesos and TYBA websites let you look up one process at a time in a browser. This actor turns the same public Consulta de Procesos Nacional Unificada (CPNU) into a bulk judicial records API: search many company or person names and radicados in one run, get every case as normalized JSON, CSV, or Excel, apply role, department, and date filters, and receive the full actuaciones timeline for each process, ready for due diligence, KYB, litigation search, and background-check pipelines.

Is this an official Rama Judicial tool? No. This actor is independent and has no affiliation with the Rama Judicial of Colombia. It reads only data that is publicly available through the Consulta de Procesos platform.

Related scrapers

• Colombia Company Financials Scraper: Colombian company financial statements from Supersociedades.
• Argentina Companies Scraper: Argentine company registry and tax IDs.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

---

Independent tool, not affiliated with the Rama Judicial of Colombia. Accesses only publicly available Consulta de Procesos data.

---

Scraper de Procesos de la Rama Judicial de Colombia

Extraiga registros de procesos judiciales de Colombia desde la Rama Judicial y su plataforma Consulta de Procesos Nacional Unificada (CPNU) por nombre de empresa, nombre de persona o número de radicado exacto. Es una consulta de procesos de la rama judicial y una API de registros judiciales de Colombia en un solo actor, pensada para debida diligencia legal, KYB y búsqueda de litigios. A continuación un resultado real, con todos los campos que devuelve el actor (el arreglo actuaciones tiene 7 movimientos; aquí se muestran 2, todos los valores son reales):

{
  "radicado": "13001310300320170056402",
  "despacho": "DESPACHO 000 - TRIBUNAL SUPERIOR - CIVIL - FAMILIA - CARTAGENA *",
  "processType": "Sin Tipo de Proceso",
  "processClass": "Sin Tipo de Proceso",
  "subClass": "Sin Subclase de Proceso",
  "recurso": "Sin Tipo de Recurso",
  "ponente": "MAG. JOHN FREDDY SAZA PINEDA",
  "ubicacion": "Secretaria",
  "courtCode": "130012213000",
  "contenidoRadicacion": "3C: 200,201-400,401-649 VERBAL REIVINDICATORIO EN APELACIÒN DE AUTO",
  "department": "BOLÍVAR",
  "cityCode": "13001",
  "filingYear": 2017,
  "demandantes": ["GRUPO ARGOS S.A."],
  "demandados": ["WALFREDO PACHECO HERNANDEZ", "EDGARDO PACHECO POLO", "NARCILA PACHECO DE GUERRERO", "JUAN ANDRES PACHECO", "BONIFACIO PACHECO DE LA ROSA"],
  "otrosSujetos": [],
  "sujetosProcesales": [
    {"name": "GRUPO ARGOS S.A.", "role": "demandante", "roleLabel": "Demandante", "docType": null, "docNumber": null},
    {"name": "WALFREDO PACHECO HERNANDEZ", "role": "demandado", "roleLabel": "Demandado", "docType": null, "docNumber": null}
  ],
  "sujetosCount": 6,
  "filingDate": "2019-08-27",
  "lastActionDate": "2019-12-18",
  "lastActionDaysAgo": 2443,
  "isPrivate": false,
  "idProceso": 59607293,
  "url": "https://consultaprocesos.ramajudicial.gov.co",
  "actuacionesCount": 7,
  "observedAt": "2026-08-26T12:28:20.980Z",
  "error": null
}

El scraper más completo de la Rama Judicial de Colombia disponible, y el único en la Apify Store. Devuelve todos los campos que la plataforma de Consulta de Procesos expone para cada proceso judicial, desde el despacho, el ponente, los sujetos procesales y la clasificación del proceso hasta la línea de tiempo completa de actuaciones, más campos derivados (año de radicación, códigos de ciudad y despacho, días desde la última actuación, número de partes) y 11 filtros para apuntar exactamente a los casos que necesita. Complementos de IA opcionales resumen, traducen y extraen datos estructurados de cada caso.

📥 Entrada · 📤 Salida · 💰 Precios · ▶️ Ejemplos

Qué hace

Este es un scraper de la Rama Judicial y una API de consulta de procesos de Colombia en un mismo actor. Busca en la plataforma Consulta de Procesos Nacional Unificada (CPNU) de la rama judicial por nombre de empresa o persona, o por radicado exacto (número de proceso de 23 dígitos), y escribe un registro normalizado por proceso judicial en el dataset de la ejecución. Cada registro trae el radicado, el despacho con sus códigos completo y de ciudad, el tipo, la clase y la subclase de proceso, el magistrado ponente, el departamento y los sujetos procesales (demandantes, demandados, otros sujetos) como arreglos, como una lista estructurada sujetosProcesales con roles, y como cadena de texto cruda. Con los detalles activados, también devuelve la línea de tiempo completa de actuaciones (movimientos del proceso) con fechas, anotaciones y fechas inicial y final. Los valores ausentes en la fuente se devuelven como null, nunca inventados.

Once filtros de entrada le permiten apuntar exactamente a los casos que quiere: tipo de persona, código de despacho o ciudad, rol de la parte (demandante o demandado), uno o varios departamentos, rango de fecha de radicación y fecha de última actuación, además de interruptores para incluir u omitir detalles y actuaciones por velocidad. Tres complementos de IA de pago opcionales se agregan encima: un resumen en español sencillo, una traducción y resumen en inglés, y una extracción estructurada del caso (tipo de pretensión, despacho, cuantías). Cada uno se cobra solo cuando produce una salida útil.

Cómo nos comparamos

Actualmente no existe ningún otro scraper de la Rama Judicial de Colombia ni de registros judiciales colombianos en la Apify Store, así que en Apify esta es la única opción lista para usar. Las alternativas reales son unas pocas API y portales comerciales colombianos independientes (por ejemplo apitude.co, coresoft.solutions, NBI, expedientes.co) y scrapers genéricos de cortes de EE. UU. (PACER, RECAP, CourtListener) que no cubren Colombia en absoluto.

Capacidad	Este actor	API o portal judicial colombiano típico	Scrapers de cortes de EE. UU. (PACER / CourtListener)
Cobertura de la Rama Judicial de Colombia	Sí, a nivel nacional (CPNU)	Sí	No
Búsqueda por nombre de empresa o persona	Sí (por lotes, muchos por ejecución)	Normalmente uno a la vez	N/D
Búsqueda por radicado exacto	Sí (por lotes)	Sí	N/D
Línea de tiempo completa de actuaciones	Sí, con fechas y anotaciones	Rara vez	N/D
Sujetos procesales estructurados con roles	Sí (sujetosProcesales)	Parcial	N/D
Filtros (rol, departamento, rango de fechas, activos)	Sí, 11 entradas	Mínimos	N/D
Campos derivados (año de radicación, códigos, días desde la última actuación)	Sí	No	N/D
Búsqueda múltiple masiva en una ejecución	Sí	No	N/D
Exportar a JSON, CSV, Excel	Sí	Varía	Sí
Pago por resultado, sin cobro por fallo	Sí	Precios por contacto comercial	Varía

Por qué elegir este actor: obtiene toda la superficie del caso (partes, clasificación y cada movimiento) en una sola llamada, búsqueda masiva de múltiples nombres y múltiples radicados, filtros que ningún portal ofrece, y facturación transparente por resultado sin cobro en ejecuciones vacías o fallidas.

Casos de uso

• Debida diligencia legal y KYB en Colombia. Consulte el historial de litigios de una empresa (razón social) antes de vincular, invertir o firmar, y vea demandantes, demandados, despachos y estado del caso.
• Riesgo de litigios y verificación de antecedentes. Analice contrapartes, proveedores o personas por procesos judiciales activos e históricos en todos los departamentos de Colombia.
• Monitoreo de casos para firmas de abogados. Siga sus propios expedientes o los de la contraparte y vigile nuevas actuaciones filtrando por fecha de última actuación.
• Cobranza y recuperación de cartera. Encuentre procesos judiciales vinculados a un deudor y siga su etapa procesal.
• Cumplimiento, prevención de lavado de activos y evaluación de proveedores. Sume verificaciones de registros judiciales de Colombia a sus flujos de vinculación y revisión periódica.
• Periodismo e investigaciones. Investigue litigios que involucren empresas públicas, funcionarios u organizaciones, con el historial completo de movimientos.

Inicio rápido

Abra el actor, pegue esto en la entrada y presione Ejecutar. Devuelve hasta 10 procesos judiciales de una empresa, con la línea de tiempo completa de actuaciones.

{
  "searchNames": ["GRUPO ARGOS S.A."],
  "tipoPersona": "jur",
  "maxRecords": 10,
  "withDetails": true,
  "withActuaciones": true,
  "onlyActive": false
}

Busque por nombre con searchNames (ponga tipoPersona en jur para una empresa o nat para una persona), o consulte procesos exactos con radicados. Un nombre de empresa muy amplio puede coincidir con más de mil procesos; acótelo con despacho (un prefijo de código de despacho o ciudad) o con los filtros role, departments y de rango de fechas. Para una ejecución más rápida solo de metadatos, ponga withActuaciones en false.

Referencia de entrada

Campo	Tipo	Requerido	Predeterminado	Descripción
searchNames	string[]	no	["GRUPO ARGOS S.A."]	Nombres de empresa (razón social) o de persona a buscar. Por lotes: una búsqueda por nombre.
radicados	string[]	no	(vacío)	Radicado exacto de 23 dígitos (número de proceso) para consultar directamente. Por lotes.
tipoPersona	enum	no	jur	Si el nombre buscado es persona jurídica (jur) o persona natural (nat).
despacho	string	no	(vacío)	Prefijo opcional de código de despacho o ciudad para acotar una búsqueda por nombre en la fuente, por ejemplo 11001 para Bogotá.
onlyActive	boolean	no	false	Cuando está activo, conserva solo procesos marcados como activos por la fuente.
role	enum	no	any	Conserva solo casos donde el nombre buscado es demandante o demandado. any conserva todos.
departments	string[]	no	(vacío)	Conserva solo casos cuyo departamento coincide con uno de estos valores (contiene, sin distinguir mayúsculas), por ejemplo ANTIOQUIA.
filedFrom	string	no	(vacío)	Conserva solo casos radicados en o después de esta fecha (YYYY-MM-DD).
filedTo	string	no	(vacío)	Conserva solo casos radicados en o antes de esta fecha (YYYY-MM-DD).
lastActionFrom	string	no	(vacío)	Conserva solo casos cuya última actuación fue en o después de esta fecha (YYYY-MM-DD).
withDetails	boolean	no	true	Cuando está activo, consulta la página de detalle (tipo, clase, ponente, código de despacho, ubicación). Agrega el evento details por proceso.
withActuaciones	boolean	no	true	Cuando está activo (y los detalles activos), consulta la línea de tiempo completa de actuaciones. Desactívelo para omitir la paginación de movimientos y acelerar la ejecución.
maxRecords	integer	no	10	Número máximo de registros de procesos judiciales en todas las búsquedas. Los planes gratuitos de Apify están limitados a 10.
withSummary	boolean	no	false	Complemento de IA de pago. Resumen en español sencillo del caso. Se cobra solo con salida de IA útil. Requiere un plan de Apify de pago.
withTranslate	boolean	no	false	Complemento de IA de pago. Traducción y resumen claros en inglés del caso. Se cobra solo con salida de IA útil. Requiere un plan de Apify de pago.
withExtract	boolean	no	false	Complemento de IA de pago. Extrae datos estructurados del caso (tipo de pretensión, despacho, cuantías). Se cobra solo con salida de IA útil. Requiere un plan de Apify de pago.

Los filtros role, departments, filedFrom, filedTo y lastActionFrom se aplican a los registros devueltos; los casos filtrados nunca se cobran. despacho, onlyActive y tipoPersona se aplican en la fuente.

Referencia de salida

Un elemento del dataset por proceso judicial. Tipos: string, integer, boolean, string[], object[] o null cuando el valor de la fuente está ausente.

Campo	Tipo	Descripción
radicado	string	Número de proceso de 23 dígitos (único por proceso).
despacho	string	Despacho u oficina que tramita el proceso.
courtCode	string	Código completo del despacho (codDespachoCompleto). Presente con detalles activos.
cityCode	string	Prefijo de ciudad o despacho (primeros 5 dígitos del radicado).
filingYear	integer	Año de radicación del proceso, derivado del radicado o de la fecha de radicación.
processType	string	Tipo de proceso.
processClass	string	Clase de proceso.
subClass	string	Subclase de proceso.
recurso	string	Tipo de recurso.
ponente	string	Magistrado ponente o juez.
ubicacion	string	Ubicación física actual del expediente.
contenidoRadicacion	string	Descripción del contenido de la radicación.
department	string	Departamento (región) del despacho.
demandantes	string[]	Demandantes.
demandados	string[]	Demandados.
otrosSujetos	string[]	Otros sujetos e intervinientes. Arreglo vacío cuando no hay.
sujetosProcesales	object[]	Sujetos estructurados. Cada uno tiene name, role (demandante/demandado/otro), roleLabel, docType, docNumber. Los números de documento no los expone la fuente y son null.
sujetosCount	integer	Número de sujetos procesales.
partiesRaw	string	Todos los sujetos con sus roles como una sola cadena cruda.
filingDate	string	Fecha de radicación (YYYY-MM-DD).
lastActionDate	string	Fecha del último movimiento del caso (YYYY-MM-DD).
lastActionDaysAgo	integer	Días enteros entre la última actuación y la fecha de la ejecución.
lastUpdate	string	Fecha en que la fuente actualizó el registro por última vez (YYYY-MM-DD). Presente con detalles activos.
isPrivate	boolean	true cuando el proceso está marcado como privado.
idProceso	integer	ID interno del proceso en la plataforma (usado para consultas de detalle y movimientos).
idConexion	integer	ID de conexión de la jurisdicción en el sistema fuente.
idRegProceso	integer	ID de registro del proceso de la página de detalle. Presente con detalles activos.
url	string	URL de consulta de la Rama Judicial.
actuacionesCount	integer	Número de actuaciones (movimientos del proceso).
actuaciones	object[]	Línea de tiempo de movimientos. Cada elemento tiene id, consecutivo, actuacion, anotacion, date, startDate, endDate, registeredDate, ruleCode y hasDocuments. Presente cuando detalles y movimientos están activos.
aiSummary	string	Resumen de IA en español sencillo, o null salvo que el complemento esté activo.
aiSummaryEn	string	Traducción y resumen de IA en inglés, o null salvo que el complemento esté activo.
aiExtract	object	Datos estructurados extraídos por IA (tipo de pretensión, despacho, cuantías), o null salvo que esté activo.
observedAt	string	Marca de tiempo ISO 8601 de cuándo se recolectó el registro.
error	string	null en caso de éxito. En una búsqueda fallida o demasiado amplia, se escribe en su lugar un único elemento con el campo error poblado, y no se cobra.

Ejecutar por API y CLI

Inicie una ejecución y espere a que termine, luego lea el dataset. Reemplace <TOKEN> por su token de API de Apify.

Ejecución sincrónica que devuelve los elementos del dataset en una sola llamada:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~colombia-rama-judicial-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchNames":["GRUPO ARGOS S.A."],"tipoPersona":"jur","despacho":"11001","withDetails":true,"maxRecords":10}'

Iniciar una ejecución de forma asíncrona:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~colombia-rama-judicial-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"radicados":["13001310300320170056402"],"withDetails":true,"withActuaciones":true}'

CLI de Apify:

apify call scrapers_lat/colombia-rama-judicial-scraper \
  --input '{"searchNames":["GRUPO ARGOS S.A."],"tipoPersona":"jur","role":"demandante","maxRecords":10}'

Obtener resultados

Cada ejecución escribe en un dataset. Obtenga los elementos como JSON, CSV o Excel cambiando format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginar datasets grandes
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> se devuelve como defaultDatasetId en el objeto de la ejecución. Use offset y limit para recorrer grandes conjuntos de resultados. clean=true descarta los campos vacíos e internos.

Facturación y límites

• Pago por resultado. Se cobra por cada registro de proceso judicial devuelto (evento result). Vea la pestaña de precios para el precio por resultado vigente.
• Complemento de detalles. Cuando withDetails está activo, cada proceso enriquecido con su página de detalle cobra el evento details. Desactívelo para ejecuciones solo de listado, de menor costo.
• Complementos de IA de pago. ai_summary, ai_translate y ai_extract son eventos separados, cada uno cobrado solo cuando produce una salida útil. Déjelos apagados para pagar solo por resultados.
• Sin cobro por fallo. Si una ejecución falla, una búsqueda es demasiado amplia o un caso se filtra, el actor no lo cobra. Las ejecuciones vacías no cuestan nada.
• Se respeta el límite de gasto. Configure maxTotalChargeUsd en la ejecución; una vez alcanzado, el actor deja de emitir y de cobrar más resultados facturables.
• Los planes gratuitos de Apify están limitados a 10 registros por ejecución, y los complementos de IA de pago están desactivados. Actualice para un maxRecords mayor y los complementos de IA.

Preguntas frecuentes y solución de problemas

¿Qué es un radicado? El radicado es el número de radicación de 23 dígitos que identifica de forma única un proceso judicial colombiano, por ejemplo 13001310300320170056402. Ponga uno o varios en radicados para consultar casos exactos.

Mi búsqueda devolvió un error sobre demasiados registros. ¿Por qué? Un nombre de empresa amplio puede coincidir con más de mil procesos, y la plataforma entonces pide criterios más específicos. Acote la búsqueda agregando un prefijo de código de despacho o ciudad en despacho, o por rol, departamento y filtros de fecha, o consulte radicados exactos. Ese registro de error no se cobra.

¿Puedo buscar por cédula o NIT (número de documento)? La plataforma pública de Consulta de Procesos no ofrece un endpoint de búsqueda por número de documento, así que este actor busca por nombre y por radicado. Los números de documento de las partes no los publica la fuente, por lo que docType y docNumber se devuelven como null.

¿Cómo encuentro solo casos con actividad reciente? Ponga lastActionFrom en una fecha, y opcionalmente active onlyActive. Cada registro también incluye lastActionDaysAgo para que pueda ordenar por recencia.

¿Empresa o persona: qué tipoPersona? Use jur para una persona jurídica (empresa, razón social) y nat para una persona natural.

¿Por qué el arreglo actuaciones está vacío o ausente? Active withDetails y withActuaciones para consultar la página de detalle y la línea de tiempo de movimientos. Algunos procesos tampoco tienen movimientos registrados aún.

¿Los complementos de IA necesitan un plan de pago? Sí. Los complementos de resumen, traducción y extracción de IA requieren un plan de Apify de pago y se cobran solo cuando devuelven una salida útil.

¿En qué se diferencia del sitio web gratuito de consulta de procesos de la Rama Judicial? Los sitios oficiales de consulta de procesos y TYBA permiten consultar un proceso a la vez en un navegador. Este actor convierte la misma Consulta de Procesos Nacional Unificada (CPNU) pública en una API de registros judiciales masiva: busque muchos nombres de empresa o persona y radicados en una ejecución, obtenga cada caso como JSON, CSV o Excel normalizado, aplique filtros de rol, departamento y fecha, y reciba la línea de tiempo completa de actuaciones de cada proceso, lista para flujos de debida diligencia, KYB, búsqueda de litigios y verificación de antecedentes.

¿Es una herramienta oficial de la Rama Judicial? No. Este actor es independiente y no tiene afiliación con la Rama Judicial de Colombia. Lee únicamente datos que están disponibles públicamente a través de la plataforma de Consulta de Procesos.

---

Herramienta independiente, sin afiliación con la Rama Judicial de Colombia. Accede únicamente a datos de Consulta de Procesos disponibles públicamente.