---
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`

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.

---

[API](https://skmtc.net/openlaws/apis/openlaws-api-documentation.md) · [All operations](https://skmtc.net/openlaws/apis/openlaws-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openlaws/openlaws-api-documentation/revisions/2cc125dd186d/schema)
