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

# Rama Judicial Cases by Radicado (Batch)

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

## Request

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

Resolve up to 50 Colombian judicial cases by radicado in one request. Returns one result per radicado in input order, each with its own status, so a single bad radicado never fails the batch. Each item counts as one request against your quota.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `items` object[], required: 1-50 request objects, each identical to the single endpoint's body. Results are returned in the same order. Each item counts as one request against your quota.
    - `registration_number` string, required: The judicial case number (radicado), normally 23 digits, e.g. `11001600001720180327700`. 20-25 digits accepted.

## Response `200`

Successful response

- RamaJudicialBatchResponse
  - `data` object, required
    - `results` object[], required: One entry per input item, in input order. `data` is present when status=completed; `error` when status=error.
      - `index` integer, required: 0-based position in the request `items` array.
      - `status` 'completed' | 'error', required
      - `cache_hit` boolean: Present on completed items; true when served from cache.
      - `data` RamaJudicialCaseData
        - `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
      - `error` BatchItemError: Per-item error envelope, same shape as the single endpoint's error.
        - `type` string, required
        - `code` string, required
        - `message` string, required
    - `summary` BatchSummary, required
      - `total` integer, required
      - `completed` integer, required
      - `errors` integer, required
      - `cache_hits` integer, required

## Other responses

- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal 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)