curl --request POST \
--url https://api.croma.run/co/samai/processes/v1 \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"search_type": "radicado",
"query": "25000-23-41-000-2016-00521-00"
}
'import requests
url = "https://api.croma.run/co/samai/processes/v1"
payload = {
"search_type": "radicado",
"query": "25000-23-41-000-2016-00521-00"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({search_type: 'radicado', query: '25000-23-41-000-2016-00521-00'})
};
fetch('https://api.croma.run/co/samai/processes/v1', 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.croma.run/co/samai/processes/v1",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'search_type' => 'radicado',
'query' => '25000-23-41-000-2016-00521-00'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.croma.run/co/samai/processes/v1"
payload := strings.NewReader("{\n \"search_type\": \"radicado\",\n \"query\": \"25000-23-41-000-2016-00521-00\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.croma.run/co/samai/processes/v1")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"search_type\": \"radicado\",\n \"query\": \"25000-23-41-000-2016-00521-00\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.croma.run/co/samai/processes/v1")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"search_type\": \"radicado\",\n \"query\": \"25000-23-41-000-2016-00521-00\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"search_type": "radicado",
"criterio": "<string>",
"corporacion": "<string>",
"total": 123,
"total_pages": 123,
"page": 123,
"per_page": 123,
"count": 123,
"results": [
{
"radicado": "<string>",
"corporacion": "<string>",
"ponente": "<string>",
"clase": "<string>",
"filing_date": "<string>",
"is_current": true,
"internal_number": "<string>",
"subject": "<string>",
"plaintiff": "<string>",
"defendant": "<string>",
"is_private": true,
"guid": "<string>",
"official_url": "<string>"
}
]
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"details": {}
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"details": {}
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"details": {}
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"details": {}
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"details": {}
}
}SAMAI Processes
Search live cases in Colombia’s administrative courts (Consejo de Estado, Tribunales Administrativos, Juzgados Administrativos) by case number (radicado), party name (parte) or case class (clase). Returns one page of matches with the reporting magistrate, class, filing date, parties and the official detail link. Every search runs inside one court, named by corporacion. For a radicado search send the full 23 digits and leave corporacion empty: the court is read from the number, the court where the case was filed when it ends in 00 and the court one level up when it ends in 01 or higher (a case on appeal). For parte or clase, corporacion is required: 1100103 is the Consejo de Estado, and SAMAI Corporaciones lists every other code. No results means the case is not in that court, not that it does not exist; pass another corporacion to look elsewhere. Civil, criminal, labor and family cases are not in SAMAI: use Rama Judicial Cases by Radicado for those.
curl --request POST \
--url https://api.croma.run/co/samai/processes/v1 \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"search_type": "radicado",
"query": "25000-23-41-000-2016-00521-00"
}
'import requests
url = "https://api.croma.run/co/samai/processes/v1"
payload = {
"search_type": "radicado",
"query": "25000-23-41-000-2016-00521-00"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({search_type: 'radicado', query: '25000-23-41-000-2016-00521-00'})
};
fetch('https://api.croma.run/co/samai/processes/v1', 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.croma.run/co/samai/processes/v1",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'search_type' => 'radicado',
'query' => '25000-23-41-000-2016-00521-00'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.croma.run/co/samai/processes/v1"
payload := strings.NewReader("{\n \"search_type\": \"radicado\",\n \"query\": \"25000-23-41-000-2016-00521-00\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.croma.run/co/samai/processes/v1")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"search_type\": \"radicado\",\n \"query\": \"25000-23-41-000-2016-00521-00\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.croma.run/co/samai/processes/v1")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"search_type\": \"radicado\",\n \"query\": \"25000-23-41-000-2016-00521-00\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"search_type": "radicado",
"criterio": "<string>",
"corporacion": "<string>",
"total": 123,
"total_pages": 123,
"page": 123,
"per_page": 123,
"count": 123,
"results": [
{
"radicado": "<string>",
"corporacion": "<string>",
"ponente": "<string>",
"clase": "<string>",
"filing_date": "<string>",
"is_current": true,
"internal_number": "<string>",
"subject": "<string>",
"plaintiff": "<string>",
"defendant": "<string>",
"is_private": true,
"guid": "<string>",
"official_url": "<string>"
}
]
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"details": {}
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"details": {}
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"details": {}
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"details": {}
}
}{
"error": {
"type": "<string>",
"code": "<string>",
"message": "<string>",
"param": "<string>",
"details": {}
}
}Headers
Optional client-chosen key for this request (any string up to 255 characters, e.g. a UUID). Every Croma operation is an idempotent lookup: repeating a request with the same body returns the same result and creates nothing, so retrying after a timeout or network failure is always safe. The key is echoed back in the Idempotency-Key response header so you can correlate a retry with its first attempt. Each attempt that reaches the API counts against the rate limit.
255"0f8e9a42-6b7c-4d1e-9a3f-2c5d7e8f9a0b"
Body
The court (corporación) to search in, as a 7-digit code from the corporaciones catalog, e.g. 1100103 for the Consejo de Estado. Required for party and class searches. For a radicado search leave it empty and it is read from the case number: the court where the case was filed when the number ends in 00, the court one level up when it ends in 01 or higher. No results means the case is not in that court.