curl --request GET \
--url https://api.legal.usecroma.com/v1/actions \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.legal.usecroma.com/v1/actions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.legal.usecroma.com/v1/actions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.legal.usecroma.com/v1/actions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.legal.usecroma.com/v1/actions"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.legal.usecroma.com/v1/actions")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.legal.usecroma.com/v1/actions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f",
"message": "AUTO QUE DECRETA MEDIDAS CAUTELARES",
"note": "Se decreta el embargo y retención de los dineros del demandado.",
"registration_date": "2026-08-18T00:00:00.000Z",
"action_created_at": "2026-08-19T06:02:11.000Z",
"source": "CONSULTA_PROCESOS",
"publication_url": null,
"document_url": null,
"process_id": "3f1c2a44-9b1e-4c5a-8d2f-6a7b8c9d0e1f",
"registration_number": "11001400300120240012300",
"plaintiff_name": "BANCO EJEMPLO S.A.",
"defendant_name": "CLIENTE DE EJEMPLO",
"defendant_id": "1234567890",
"defender_name": null,
"office": "JUZGADO 001 CIVIL MUNICIPAL DE BOGOTÁ",
"priority": null,
"is_private": false,
"last_discovery_date": "2026-08-20T09:14:33.000Z",
"metadata": {
"etapa": "EJECUTIVO"
}
}
],
"next_cursor": "eyJzY29yZSI6MywiZGF0ZSI6IjIwMjYtMDgtMTlUMDY6MDI6MTEuMDAwWiIsImlkIjoiYzFkMiJ9",
"has_more": true
}{
"error": {
"type": "authentication_error",
"code": "invalid_api_key",
"message": "Invalid or missing API key."
}
}{
"error": {
"type": "rate_limit_error",
"code": "rate_limited",
"message": "Rate limit exceeded. Try again in 42 seconds."
}
}{
"error": {
"type": "api_error",
"code": "internal_error",
"message": "Internal error. Contact support with the X-Request-Id if it persists."
}
}Listar actuaciones
Lista las actuaciones de todo tu portafolio de Croma Legal con paginación por cursor y filtros de fecha: cada actuación publicada, la más reciente primero.
curl --request GET \
--url https://api.legal.usecroma.com/v1/actions \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.legal.usecroma.com/v1/actions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.legal.usecroma.com/v1/actions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.legal.usecroma.com/v1/actions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.legal.usecroma.com/v1/actions"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.legal.usecroma.com/v1/actions")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.legal.usecroma.com/v1/actions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f",
"message": "AUTO QUE DECRETA MEDIDAS CAUTELARES",
"note": "Se decreta el embargo y retención de los dineros del demandado.",
"registration_date": "2026-08-18T00:00:00.000Z",
"action_created_at": "2026-08-19T06:02:11.000Z",
"source": "CONSULTA_PROCESOS",
"publication_url": null,
"document_url": null,
"process_id": "3f1c2a44-9b1e-4c5a-8d2f-6a7b8c9d0e1f",
"registration_number": "11001400300120240012300",
"plaintiff_name": "BANCO EJEMPLO S.A.",
"defendant_name": "CLIENTE DE EJEMPLO",
"defendant_id": "1234567890",
"defender_name": null,
"office": "JUZGADO 001 CIVIL MUNICIPAL DE BOGOTÁ",
"priority": null,
"is_private": false,
"last_discovery_date": "2026-08-20T09:14:33.000Z",
"metadata": {
"etapa": "EJECUTIVO"
}
}
],
"next_cursor": "eyJzY29yZSI6MywiZGF0ZSI6IjIwMjYtMDgtMTlUMDY6MDI6MTEuMDAwWiIsImlkIjoiYzFkMiJ9",
"has_more": true
}{
"error": {
"type": "authentication_error",
"code": "invalid_api_key",
"message": "Invalid or missing API key."
}
}{
"error": {
"type": "rate_limit_error",
"code": "rate_limited",
"message": "Rate limit exceeded. Try again in 42 seconds."
}
}{
"error": {
"type": "api_error",
"code": "internal_error",
"message": "Internal error. Contact support with the X-Request-Id if it persists."
}
}Autorizaciones
Use Authorization: Bearer YOUR_API_KEY
Parámetros de consulta
Partial, case-insensitive match on the case's registration number (radicado).
Keyword in the actuación text (case insensitive), e.g. sentencia, notificación.
Partial match on the defendant name.
Partial match on the defendant identification number (cédula or NIT).
Partial match on the judicial office (despacho).
Public source the actuación was recorded from, exactly as returned in source (e.g. CONSULTA_PROCESOS, PUBLICACIONES_PROCESALES, TYBA).
ISO 8601 date-time. Only actuaciones on or after this instant, on the column chosen by since_mode.
ISO 8601 date-time. Only actuaciones strictly before this instant, on the column chosen by since_mode.
Which date since / until (and the ordering) use. discovered (default): when Croma recorded the actuación (action_created_at), the right choice for "what is new since my last sync". judicial: the actuación's own date (registration_date).
discovered, judicial Opaque pagination cursor from a previous response's next_cursor. Omit for the first page.
Rows per page (default 25, max 100).
1 <= x <= 100