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), a radicado, or a process class.

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:""

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.

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