Colombia
SAMAI / Consejo de Estado

SAMAI Processes

Search live contentious-administrative processes (Consejo de Estado plus every Tribunal and Juzgado Administrativo) by party, radicado, or class, scoped to a corporación. Returns one page of matches with the reporting magistrate, class, filing date, parties and the official detail link. A parte or clase search requires corporacion: use 1100103 for the Consejo de Estado, or get a Tribunal or Juzgado code from SAMAI Corporaciones first. A radicado search derives the corporación from the radicado when none is given.

post/co/samai/processes/v1

Request

  • Base URL: https://api.croma.run
  • URL: https://api.croma.run/co/samai/processes/v1
  • Auth: HTTP bearer

Headers

Idempotency-Keystring
Example:0f8e9a42-6b7c-4d1e-9a3f-2c5d7e8f9a0b

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.

Request body

search_type'radicado' | 'clase' | 'parte'

Search by parte (party name), radicado (case number), or clase (process class).

querystring required

The value to search for: a party name (parte), a radicado, or a process class.

corporacionstring

Corporación (despacho) code to scope the search, e.g. 1100103 for the Consejo de Estado. Required for party/class searches; for a radicado search it is inferred when omitted. List codes with the corporaciones catalog.

sectionstring

Optional sección (chamber) code to narrow the search.

from_datestring date

Optional date filter in yyyy-mm-dd format.

to_datestring date

Optional date filter in yyyy-mm-dd format.

pageinteger

1-based page number for paginated results.

per_pageinteger

Results per page (1-50).

Response

Successful response

Changes

No recorded changes to this operation across all 1 revision of this API.