Skip to main content
POST
Tribunal Supremo de Justicia de Bolivia Rulings Search

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

Optional search terms matched against the resolution number, the case number, the chamber, the jurisprudence notes (descriptor, restrictor, ratio decidendi) and the full text.

Maximum string length: 300
chamber
string
default:""

Optional chamber as chamber names it, e.g. Sala Civil, Sala Penal, Sala Plena or Sala Contenciosa, matched from the start. Case and accents are ignored.

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

Optional kind of resolution: auto_supremo, sentencia or resolucion.

Available options:
,
auto_supremo,
sentencia,
resolucion
subject
string
default:""

Optional area of law as subject names it, e.g. Civil, Penal, Familia, Social, Agrario, matched from the start. Case and accents are ignored.

Maximum string length: 120
outcome
string
default:""

Optional outcome as outcome names it, e.g. Infundado, Casa, Improcedente, Anula, matched from the start. Case and accents are ignored.

Maximum string length: 120
registration_number
string
default:""

Optional resolution number as the court prints it, e.g. AS/0001/2013 or SE/0001/2023. Each chamber numbers its own resolutions, so a number can return several; add chamber to narrow it. Case, spaces and punctuation are ignored.

Maximum string length: 80
case_number
string
default:""

Optional case file number (expediente) as the court prints it. Case, spaces and punctuation are ignored.

Maximum string length: 80
reporting_judge
string
default:""

Optional reporting justice (magistrado relator) as reporting_judge names them, matched from the start of the name. Case and accents are ignored.

Maximum string length: 160
department
string
default:""

Optional department the case came from, e.g. La Paz, Santa Cruz, Chuquisaca, matched from the start. Case and accents are ignored.

Maximum string length: 60
year
integer
default:0

Optional year of the resolution. 0 searches every year.

Required range: 0 <= x <= 2100
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:20

Results per page (1-50).

Required range: 1 <= x <= 50

Response

Successful response

data
object
required