--- title: "Courts of Japan Ruling" method: POST path: "/jp/courts-jp/ruling/v1" tags: ["Japan", "Courts of Japan"] --- # Courts of Japan Ruling `POST /jp/courts-jp/ruling/v1` ## Request - Base URL: `https://api.croma.run` - URL: `https://api.croma.run/jp/courts-jp/ruling/v1` - Auth: HTTP bearer Retrieve one ruling of the courts of Japan by its `id` from a search result (e.g. `93117`) or its `official_url`: its full text, the case number and name, the court, the date, the outcome, the court's summary and the statutes cited, the court's document as published, and the link to its page at the courts. The text comes back a character range at a time (`offset`, `limit`); follow `next_offset` until `has_more` is false. **Dataset endpoint**: answers from the whole source in milliseconds and carries `as_of`. ## Headers - `Idempotency-Key` string ## Request body - object - `ruling_id` string, required: The ruling's `id` from a search result, e.g. `93117`. Its `official_url` or `source_document_url` works too. - `offset` integer: First character of the range to return. Pass the previous response's `next_offset` to continue reading. - `limit` integer: Maximum characters to return (1000-1000000). ## Response `200` Successful response - CourtsJpRulingResponse - `data` CourtsJpRulingData, required - `as_of` string, nullable, required: How current the data in this response is. - `found` boolean, required - `ruling_id` string, required - `ruling` object, nullable, required - `id` string, required: The ruling's permanent number at the courts' site, e.g. "93117". Unique across every collection. - `collections` string[], required: The collections the courts publish the ruling in: `supreme` (最高裁判所判例集), `high` (高等裁判所判例集), `lower` (下級裁判所裁判例速報), `administrative` (行政事件裁判例集), `labor` (労働事件裁判例集), `ip` (知的財産裁判例集), `ip_high` (知的財産高等裁判所). One ruling can sit in several. - `case_number` string, nullable, required: The case number as the court prints it, e.g. "平成21(オ)257", "令和7(あ)868". - `case_year` number, nullable, required: The Gregorian year the case was filed, from its number. - `title` string, nullable, required: The case name (事件名), e.g. "損害賠償請求事件". Null when the court published none. - `ruling_date` string, required: `yyyy-mm-dd` the ruling was handed down. - `ruling_date_japanese` string, nullable, required: The same date in the Japanese calendar, e.g. "平成22年6月17日". - `year` number, required: The year of the ruling. - `court` string, nullable, required: The court, and for the Supreme Court its bench, e.g. "最高裁判所第一小法廷", "東京高等裁判所", "大阪地方裁判所". - `branch` string, nullable, required: The branch of the court (支部), when the ruling names one. - `department` string, nullable, required: The division of the court (部), when the ruling names one. - `judgment_type` string, nullable, required: The kind of decision, e.g. "判決" (judgment), "決定" (decision). - `result` string, nullable, required: The outcome as the court records it, e.g. "棄却", "破棄差戻", "却下", "その他". - `reporter` string, nullable, required: The official reports citation (判例集等巻・号・頁), when the ruling is reported. - `lower_court` string, nullable, required: The court whose decision was appealed (原審), when there is one. - `lower_case_number` string, nullable, required: The case number at the lower court. - `lower_ruling_date` string, nullable, required: `yyyy-mm-dd` of the lower court's decision. - `lower_result` string, nullable, required: The lower court's outcome, when the courts state it. - `holding` string, nullable, required: The court's statement of what was decided (判示事項), when published. - `gist` string, nullable, required: The court's summary of the reasoning (裁判要旨 or 要旨), when published. - `statutes` string, nullable, required: The provisions the ruling turns on (参照法条), as the court lists them. - `field` string, nullable, required: The field the courts file an administrative or labour case under (分野), when stated. - `right_type` string, nullable, required: For an intellectual property case, the right at issue (権利種別), e.g. "特許権", "著作権", "商標権". - `suit_type` string, nullable, required: For an intellectual property case, the kind of suit (訴訟類型), e.g. "民事訴訟", "審決取消". - `ip_case_kind` string, nullable, required: For an IP High Court case, the kind of case (事件種別). - `invention` string, nullable, required: For an IP High Court case, the title of the invention, mark or work (発明等の名称等). - `issues` string, nullable, required: For an IP High Court case, the main issues (主な争点). - `appeal` string, nullable, required: For an IP High Court case, whether a further appeal was lodged (上告提起等の有無). - `appeal_result` string, nullable, required: For an IP High Court case, the result of that appeal (上告審の結果). - `ip_result` string, nullable, required: For an IP High Court case, the outcome as that court records it (判決結果). - `text_status` 'ok' | 'scanned' | 'missing', required: `ok` when the full text is here; `scanned` when the court's document carries no text layer; `missing` when the court published no document. - `official_url` string, required: The ruling's page at the courts' site. - `document_url` string, nullable, required: Croma's copy of the court's document (PDF), byte for byte as published. It stays available whatever happens to the court's own site. Null when the court published none. - `source_document_url` string, nullable, required: The document's own link at the courts' site. - `content` object, nullable, required: A range of the ruling's text, or null when `text_status` is not `ok`. - `text` string, required: The requested character range of the ruling's text. - `offset` number, required: First character of the range, which is where the reading actually started. - `total_length` number, required: Length of the whole text in characters, however much of it this response carries. - `has_more` boolean, required: Whether the text continues past this range. - `next_offset` number, nullable, required: Pass this back as `offset` to read the next range. Null at the end of the text. ## Other responses - `400`: Invalid request body - `401`: Missing or invalid API key - `429`: Rate limit exceeded - `500`: Internal error - `502`: Upstream source returned an error --- [API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)