Skip to main content
POST
SAMAI Processes

Authorizations

Authorization
string
header
required

Use Authorization: Bearer YOUR_API_KEY

Headers

Idempotency-Key
string

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.

Maximum string length: 255
Example:

"0f8e9a42-6b7c-4d1e-9a3f-2c5d7e8f9a0b"

Body

application/json
query
string
required

The value to search for: a party name (parte), the full 23-digit case number with or without dashes (radicado), or a process class (clase).

Required string length: 2 - 200
search_type
enum<string>
default:parte

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

Available options:
radicado,
clase,
parte
corporacion
string
default:""

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.

section
string
default:""

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

Maximum string length: 20
from_date
string<date>
default:""

Optional date filter in yyyy-mm-dd format.

to_date
string<date>
default:""

Optional date filter in yyyy-mm-dd format.

page
integer
default:1

1-based page number for paginated results.

Required range: 1 <= x <= 1000
per_page
integer
default:10

Results per page (1-50).

Required range: 1 <= x <= 50

Response

Successful response

data
object
required