---
title: "Rama Judicial Cases by Radicado"
method: POST
path: "/co/rama-judicial/cases-by-radicado/v1"
tags: ["Colombia", "Rama Judicial"]
---

# Rama Judicial Cases by Radicado

`POST /co/rama-judicial/cases-by-radicado/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/co/rama-judicial/cases-by-radicado/v1`
- Auth: HTTP bearer

Resolve a Colombian judicial case by radicado and return case metadata plus the first 40 actuaciones (actions) available.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `registration_number` string, required: The judicial case number (radicado), normally 23 digits, e.g. `11001600001720180327700`. 20-25 digits accepted.

## Response `200`

Successful response

- RamaJudicialCaseResponse
  - `data` RamaJudicialCaseData, required
    - `found` boolean, required: Whether a public case matched the radicado. When false, primary_case is null.
    - `registration_number` string, required
    - `case_ids` integer[], required
    - `primary_case` object, nullable, required
      - `id` integer, required
      - `connection_id` integer, required
      - `registration_number` string, required
      - `start_date` string, nullable, required
      - `last_action_date` string, nullable, required
      - `court` string, required
      - `department` string, nullable, required
      - `parties_text` string, nullable, required
      - `is_private` boolean, required
    - `actions` object[], required
      - `id` integer, required
      - `registration_number` string, required
      - `sequence` integer, required
      - `action_date` string, nullable, required
      - `action_type` string, required
      - `note` string, nullable, required
      - `start_date` string, nullable, required
      - `end_date` string, nullable, required
      - `registered_date` string, nullable, required
      - `has_documents` boolean, required
    - `pagination` object, required
      - `total` integer, required
      - `page_size` integer, required
      - `total_pages` integer, required
      - `page` integer, required
    - `private_only` boolean

## Other responses

- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)