---
title: "Lookup Case Opinion by Jurisdiction and Bluebook legal citation for a case"
method: GET
path: "/api/v1/jurisdictions/{jurisdiction_key}/opinions/citations"
tags: ["Opinions"]
---

# Lookup Case Opinion by Jurisdiction and Bluebook legal citation for a case

`GET /api/v1/jurisdictions/{jurisdiction_key}/opinions/citations`

## Request

- Base URL: `https://api.openlaws.us`
- URL: `https://api.openlaws.us/api/v1/jurisdictions/{jurisdiction_key}/opinions/citations`
- Auth: HTTP bearer

Long form with parties or short form of case citations (volume-number reporter-abbrevation first-page-number) will work.

## Path parameters

- `jurisdiction_key` string, required

## Query parameters

- `query` string, required

## Response `200`

Array of Opinions

- Opinion[]
  - `case_name` string, nullable, required: Full case name including first and second parties
  - `jurisdiction_key` string, nullable, required: Two to three letter Jurisdiction Key. `FED` for federal and generally, the postal abbreviation for most U.S. states and territories.
  - `court` Court, required: Represents a single Court and closely aligns to CourtListener's data set. Courts contain Opinions.
    - `key` string: Unique identifier for the court
    - `jurisdiction` string: Two to three letter Jurisdiction Key. `FED` for federal and generally, the postal abbreviation for most U.S. states and territories.
    - `parent_court_key` string, nullable: Parent court key if applicable
    - `name` string
    - `short_name` string
    - `abbreviation` string
    - `start_date` string, date, nullable: Nullable ISO 8601 Date
    - `end_date` string, date, nullable: Nullable ISO 8601 Date
  - `docket_number` string: Court docket identifier for the opinion
  - `date_filed` string, date: Date which the opinion was filed (ISO formatted date)
  - `judges` string: Name of judges if available
  - `attorneys` string: Name of attorneys if available
  - `first_party` string
  - `second_party` string
  - `precedential_status` string: Published or unpublished
  - `headmatter` string: Markdown of headmatter if available
  - `extracted_by_ocr` boolean: Whether or not OCR was used to extract the text
  - `plaintext_content` string: Plain text representation of the opinion text, if available. Otherwise, empty string.
  - `updated_at` string, date-time: ISO 8601 DateTime
  - `citations` string[]: Array of possible citations for the case. Can be empty for unpublished opinions.

## Other responses

- `400`: Bad Request. Please check your jurisdiction and citation format.
- `401`: Unauthorized. Check that you are passing an Authorization header with "Bearer <your-token>".
- `404`: Not Found.
- `429`: Too Many Requests. Rate limit hit. Please wait before retrying.
- `500`: Server Error.

## Changes

- **2026-07-26** `2cc125dd186d`: 18 breaking, 1 warning, 4 info
  - the response property `items/case_name` became nullable for the status `200`
  - the response property `items/court/end_date` became nullable for the status `200`
  - the response property `items/court/start_date` became nullable for the status `200`
  - the response property `items/jurisdiction_key` became nullable for the status `200`
  - …19 more

[Operation history](https://skmtc.dev/openlaws/apis/openlaws-api-documentation/changes/api/v1/jurisdictions/:jurisdiction_key/opinions/citations/get.md)

---

[API](https://skmtc.dev/openlaws/apis/openlaws-api-documentation.md) - [All operations](https://skmtc.dev/openlaws/apis/openlaws-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/openlaws/apis/openlaws-api-documentation/revisions/2cc125dd186d?raw)
