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

# Rama Judicial Cases by Entity

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

## Request

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

Search Colombian judicial cases by entity name. Optional filters narrow by entity type, court code, recent activity, and page.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `name` string, required: Entity name to search for. Letters, digits, spaces, .,'&- allowed.
  - `entity_type` 'natural' | 'juridical': Entity type: `natural` or `juridical`. Defaults to `natural`.
  - `active_only` boolean: When true, only return cases with activity in the last 30 days.
  - `court_code` string: Optional court code to scope the search to one court.
  - `page` integer: 1-based page number for paginated results.

## Response `200`

Successful response

- RamaJudicialSearchResponse
  - `data` RamaJudicialSearchData, required
    - `cases` object[], 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
    - `pagination` object, required
      - `total` integer, required
      - `page_size` integer, required
      - `total_pages` integer, required
      - `page` integer, required

## 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)