usgpo / api

services to access govinfo content and metadata
https://api.govinfo.gov
Other
184 stars 58 forks source link

USCOURTS - add courtCode and courtType parameters #79

Closed jonquandt closed 3 years ago

jonquandt commented 3 years ago

Story

As a user interested in USCOURTS materials, I want to retrieve data from a single court or type of court from the API so that I can update only the information I'm looking for.

Background

The USCOURTS collection comprises content coming from approximately 140 U.S Courts, including District, Banckruptcy, Appellate, and National Courts. When users try to use the collections or published endpoints to retrieve USCOURTS data, there is a high likelihood that they will get information from Courts that they are not specifically interested in.

Acceptance Criteria

The first result (as of the time of the initial request) has the following:

    {
      "packageId": "USCOURTS-flnd-3_19-cv-01630",
      "lastModified": "2021-02-12T01:32:08Z",
      "packageLink": "https://api.govinfo.gov/packages/USCOURTS-flnd-3_19-cv-01630/summary",
      "docClass": "USCOURTS",
      "title": "HENRY v. INCH et al",
      "congress": null,
      "dateIssued": "2021-01-19T12:00:00Z"
    },

In this case, the courtCode would be flnd

Similarly, courtType is also available within the package summary: https://api.govinfo.gov/packages/USCOURTS-flnd-3_19-cv-01630/summary?api_key=DEMO_KEY

Available courtType values are: