# Colombia Rama Judicial Court Case Scraper (`scrapers_lat/colombia-rama-judicial-scraper`) Actor
Extract Colombian court process records from the Rama Judicial CPNU lookup by name or radicado number.
- **URL**: https://apify.com/scrapers\_lat/colombia-rama-judicial-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** Business, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $10.00 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
[](https://console.apify.com/actors/kzqktH3hkyvYfAPbZ/input)
## Colombia Rama Judicial Scraper
> Extract Colombian court process records from the Rama Judicial CPNU public lookup, searchable by company or person name and by exact radicado number nationwide.
20 fields per record
Colombia nationwide courts
JSON / CSV / Excel output formats
Updated 2026-06-22
### What you get
Each record is one Colombian court process from the official Consulta de Procesos Nacional Unificada, structured for litigation screening, adverse-media checks, and counterparty due diligence:
- **radicado**: the 23-digit process number (número de radicación)
- **despacho**: the court or judicial office handling the process
- **department**: the Colombian department where the process is filed
- **demandantes**: list of plaintiffs (parte demandante)
- **demandados**: list of defendants (parte demandada)
- **otrosSujetos**: other parties, such as third-party interveners and prosecutors
- **partiesRaw**: the original full party string exactly as published by the court
- **filingDate**: the date the process was filed
- **lastActionDate**: the date of the most recent recorded movement
- **isPrivate**: whether the process is flagged as reserved or private
- **idProceso**: the internal process identifier used by the registry
- **url**: link to the public Rama Judicial process lookup
- **observedAt**: when this record was last seen by the scraper
- **processType\***: the type of process (for example Laboral, Civil, Penal)
- **processClass\***: the procedural class (for example Acción Constitucional, Ejecutivo)
- **subClass\***: the procedural subclass
- **recurso\***: the appeal or remedy stage, when applicable
- **ponente\***: the presiding judge or reporting magistrate
- **ubicacion\***: the current physical or procedural location of the file
- **contenidoRadicacion\***: a short description of the filing content
- **lastUpdate\***: when the registry last updated the process record
- **actuacionesCount\***: how many movements (actuaciones) the process has
- **actuaciones\***: full chronological list of case movements, each with the action, the clerk annotation, its date, and whether documents are attached
*\*These fields only appear when Include Process Details is set to true.*
### Who is it for
| Use case | Who benefits |
|---|---|
| Litigation and adverse-media screening | KYC and compliance teams checking Colombian counterparties |
| Credit and risk analysis | Lenders and insurers assessing exposure to active disputes |
| Due diligence | Law firms and M&A analysts mapping a target's open cases |
| Debt recovery | Collections teams tracking executive and insolvency processes |
| Case monitoring | Legal operations teams following movements on known radicados |
### Frequently Asked Questions
**What court data does the Rama Judicial lookup cover?**
It covers court processes registered in Colombia's Consulta de Procesos Nacional Unificada, across judicial offices nationwide, including civil, labor, criminal, administrative, and constitutional matters. Each process exposes its court, parties, filing and last-action dates, and its full movement history.
**Can I search by company name or only by radicado number?**
Both. Enter one or more company names or person names to find every process where that party appears, or enter exact 23-digit radicado numbers to pull specific processes directly. You can mix names and radicados in a single run.
**Why does a common company name return an error instead of results?**
The source rejects any name search that matches more than 1000 processes and asks for a more specific query. For very large companies, use the full razón social and add a court code (for example 11001 for Bogotá) to narrow the search to one city.
**What is the difference between the basic and full-detail output?**
The basic run returns the radicado, court, department, parties, and key dates straight from the search. Turn on Include Process Details and the scraper also pulls each process type, class, subclass, presiding judge, location, and the full chronological list of actuaciones (movements).
**Is this data public?**
Yes. The scraper reads only what the Rama Judicial publishes openly on its public process lookup. Processes flagged as reserved are returned with an isPrivate marker and without protected content.
### Example use cases
Ready-to-run example tasks, each preconfigured for a common scenario. Open one and press run, or use it as a template:
- [Colombina Court Cases Colombia](https://apify.com/scrapers_lat/colombia-rama-judicial-scraper/examples/colombia-colombina-court-cases): Monitor Colombian litigation involving Colombina with case numbers, courts, parties and current status for legal teams.
- [Crepes & Waffles Court Cases Colombia](https://apify.com/scrapers_lat/colombia-rama-judicial-scraper/examples/colombia-crepes-waffles-court-cases): Track Colombian court cases involving Crepes & Waffles with case number, court, parties, dates and procedural status.
- [Postobon Court Cases Colombia](https://apify.com/scrapers_lat/colombia-rama-judicial-scraper/examples/colombia-postobon-court-cases): Pull Colombian court records involving Postobon with case number, court, demandantes, demandados and case status.
### Related scrapers
Need data from the same space? Here are other scrapers we build and maintain:
- [SUNAT Peru RUC Scraper](https://apify.com/scrapers_lat/sunat-scraper): Extract Peru SUNAT taxpayer records by RUC or company name: legal name, status, tax address, CIIU...
- [Colombia SECOP Scraper](https://apify.com/scrapers_lat/colombia-secop-scraper): Extract Colombia public contracts from SECOP II (datos.gov.co): entity and supplier, NIT, contract...
- [Chile Mercado Publico Supplier & Award Scraper](https://apify.com/scrapers_lat/mercado-publico-scraper): Extract Chile state suppliers from Mercado Publico and ChileProveedores with public-procurement...
- [BCRA Argentina Debtor & Credit Risk Scraper](https://apify.com/scrapers_lat/bcra-deudores-scraper): Extract Argentina BCRA Central de Deudores credit-risk records by CUIT or CUIL: debtor name...
- [DataJud Brazil Court Case Scraper](https://apify.com/scrapers_lat/datajud-scraper): Extract Brazilian court process records from the CNJ DataJud public database across 90+ federal...
- [SAT Mexico 69-B Taxpayer Blacklist Scraper](https://apify.com/scrapers_lat/sat-69b-scraper): Extract Mexico SAT Lista 69-B (EFOS) blacklist of taxpayers presumed or confirmed to issue fake...
### More scrapers at scrapers.lat
This actor is built and maintained by [scrapers.lat](https://scrapers.lat), where we publish scrapers for Latin American and US public platforms: real estate, jobs, e-commerce, company registries and government data. Browse the full catalog, see live sample output for each one, or ask us for a custom scraper at [scrapers.lat](https://scrapers.lat).
---
> This actor is an independent tool and has no affiliation with the Rama Judicial or the Consejo Superior de la Judicatura. It only accesses court information that is publicly available on the official process lookup. This is sensitive legal data: use it only for legitimate purposes such as KYC, due diligence, and case monitoring, and in accordance with the Rama Judicial's terms of use and applicable Colombian data-protection law.
# Actor input Schema
## `maxItems` (type: `integer`):
Maximum number of court process records to collect across all searches. Optional.
## `withDetails` (type: `boolean`):
When enabled, the scraper also fetches the detail page for each process (process type, class, subclass, presiding judge, location) and the full list of actuaciones (case movements). When disabled, only the listing-level fields are returned.
## `searchNames` (type: `array`):
Company names (razón social) or person names to search for as a party in Colombian court processes. The lookup matches names that contain the text you enter. A very common name can return more than 1000 matches; in that case the source rejects the query and asks for a more specific name, optionally combined with a city/court filter below.
## `radicados` (type: `array`):
Exact 23-digit radicado (process number) to look up directly. One record is produced per matching process.
## `tipoPersona` (type: `string`):
Whether the searched name is a legal entity (company / razón social) or a natural person. Applies to name searches only.
## `despacho` (type: `string`):
Optional court/city code prefix to narrow a name search (for example 11001 for Bogotá, 05001 for Medellín, 76001 for Cali, 08001 for Barranquilla). Leave empty to search nationwide.
## `onlyActive` (type: `boolean`):
When enabled, only processes that are currently active are returned.
## `proxyConfiguration` (type: `object`):
Optional Apify proxy configuration. The Rama Judicial API normally responds to direct datacenter requests, so a proxy is not required. Enable it only if the host starts rate-limiting the run.
## Actor input object example
```json
{
"maxItems": 10,
"withDetails": true,
"searchNames": [
"ALMACENES EXITO S.A."
],
"tipoPersona": "jur",
"onlyActive": false
}
````
# Actor output Schema
## `results` (type: `string`):
No description
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"maxItems": 10,
"searchNames": [
"ALMACENES EXITO S.A."
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/colombia-rama-judicial-scraper").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"maxItems": 10,
"searchNames": ["ALMACENES EXITO S.A."],
}
# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/colombia-rama-judicial-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"maxItems": 10,
"searchNames": [
"ALMACENES EXITO S.A."
]
}' |
apify call scrapers_lat/colombia-rama-judicial-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapers_lat/colombia-rama-judicial-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Colombia Rama Judicial Court Case Scraper",
"description": "Extract Colombian court process records from the Rama Judicial CPNU lookup by name or radicado number.",
"version": "0.1",
"x-build-id": "RAVURqzeiBIZJbvbg"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapers_lat~colombia-rama-judicial-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapers_lat-colombia-rama-judicial-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/scrapers_lat~colombia-rama-judicial-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapers_lat-colombia-rama-judicial-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/scrapers_lat~colombia-rama-judicial-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapers_lat-colombia-rama-judicial-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"maxItems": {
"title": "Max Items",
"minimum": 1,
"maximum": 1000000,
"type": "integer",
"description": "Maximum number of court process records to collect across all searches. Optional."
},
"withDetails": {
"title": "Include Process Details",
"type": "boolean",
"description": "When enabled, the scraper also fetches the detail page for each process (process type, class, subclass, presiding judge, location) and the full list of actuaciones (case movements). When disabled, only the listing-level fields are returned.",
"default": true
},
"searchNames": {
"title": "Names / Razón Social",
"type": "array",
"description": "Company names (razón social) or person names to search for as a party in Colombian court processes. The lookup matches names that contain the text you enter. A very common name can return more than 1000 matches; in that case the source rejects the query and asks for a more specific name, optionally combined with a city/court filter below.",
"items": {
"type": "string"
}
},
"radicados": {
"title": "Radicado Numbers",
"type": "array",
"description": "Exact 23-digit radicado (process number) to look up directly. One record is produced per matching process.",
"items": {
"type": "string"
}
},
"tipoPersona": {
"title": "Party Type",
"enum": [
"jur",
"nat"
],
"type": "string",
"description": "Whether the searched name is a legal entity (company / razón social) or a natural person. Applies to name searches only.",
"default": "jur"
},
"despacho": {
"title": "Court Code (Codificación Despacho)",
"type": "string",
"description": "Optional court/city code prefix to narrow a name search (for example 11001 for Bogotá, 05001 for Medellín, 76001 for Cali, 08001 for Barranquilla). Leave empty to search nationwide."
},
"onlyActive": {
"title": "Only Active Processes",
"type": "boolean",
"description": "When enabled, only processes that are currently active are returned.",
"default": false
},
"proxyConfiguration": {
"title": "Proxy Configuration",
"type": "object",
"description": "Optional Apify proxy configuration. The Rama Judicial API normally responds to direct datacenter requests, so a proxy is not required. Enable it only if the host starts rate-limiting the run."
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```