Skip to main content
POST
Courts of Japan 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 words, in Japanese, matched against the case name, the court's summary (判示事項, 裁判要旨), the statutes cited and the text of the ruling: 解雇権濫用, 過払金 返還. Two or more characters; every word must appear.

Maximum string length: 300
collection
enum<string>
default:""

Optional collection: supreme (最高裁判所判例集), high (高等裁判所判例集), lower (下級裁判所裁判例速報), administrative (行政事件裁判例集), labor (労働事件裁判例集), ip (知的財産裁判例集) or ip_high (知的財産高等裁判所). A ruling can sit in more than one.

Available options:
,
supreme,
high,
lower,
administrative,
labor,
ip,
ip_high
court
string
default:""

Optional court as court names it, e.g. 最高裁判所第一小法廷, 東京高等裁判所, 大阪地方裁判所, matched from the start, so 最高裁判所 finds every bench of the Supreme Court.

Maximum string length: 80
case_number
string
default:""

Optional case number as the court prints it, e.g. 平成21(オ)257 or 令和7(あ)868. Spaces and the width of the characters are ignored.

Maximum string length: 60
year
integer
default:0

Optional year the ruling was handed down (Gregorian). 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