Skip to main content
POST
Consejo de Estado Jurisprudence Search

Authorizations

Authorization
string
header
required

Use Authorization: Bearer YOUR_API_KEY

Headers

Prefer
string

Set wait=N to hold the connection up to N seconds for an inline result. If the job finishes in time you get the normal 200 body; otherwise a 202 with a status_url to poll.

Example:

"wait=30"

Body

application/json
section
string
default:""

Optional section filter (e.g. SECCION TERCERA, SALA PLENA). Empty means all sections.

Maximum string length: 80
type
enum<string>
default:""

Filter by providencia type; empty means any.

Available options:
,
AUTO,
CONCEPTO,
SENTENCIA
registration_number
string
default:""

Optional número de proceso (radicado) filter.

Maximum string length: 40
reporting_judge
string
default:""

Optional consejero ponente filter.

Maximum string length: 120
plaintiff
string
default:""

Optional demandante (actor) filter.

Maximum string length: 120
defendant
string
default:""

Optional demandado filter.

Maximum string length: 120
statute
string
default:""

Optional norma o acto demandado filter.

Maximum string length: 120
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:5

Results per page (max 20). The source returns one record per view, so larger pages take proportionally longer.

Required range: 1 <= x <= 20
callback_url
string<uri>

POST the job result here when it finishes.

Response

Successful response

data
object
required