LibraryOfCongress / api.congress.gov

congress.gov API
601 stars 38 forks source link

(committee-print): sort by `updateDate` #213

Open ryparker opened 3 months ago

ryparker commented 3 months ago

The committee-print list API currently returns items that are not in any particular order (that I recognize). It would be ideal if there was a sort option, but at the least it would be helpful for caching purposes if all list APIs sorted by updateDate.

e.g.

curl --location 'https://api.congress.gov/v3/committee-print/118?format=json&api_key=<API_KEY>'

Response:

{
    "committeePrints": [
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 54294,
            "updateDate": "2023-12-14 00:43:19+00:00",
            "url": "https://api.congress.gov/v3/committee-print/118/house/54294?format=json"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 54293,
            "updateDate": "2023-12-14 02:15:24+00:00",
            "url": "https://api.congress.gov/v3/committee-print/118/house/54293?format=json"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 53578,
            "updateDate": "2024-01-06 12:58:11+00:00",
            "url": "https://api.congress.gov/v3/committee-print/118/house/53578?format=json"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 53374,
            "updateDate": "2024-01-14 09:15:17+00:00",
            "url": "https://api.congress.gov/v3/committee-print/118/house/53374?format=json"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 50699,
            "updateDate": "2023-02-22 22:15:57+00:00",
            "url": "https://api.congress.gov/v3/committee-print/118/house/50699?format=json"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 50894,
            "updateDate": "2023-02-27 22:28:11+00:00",
            "url": "https://api.congress.gov/v3/committee-print/118/house/50894?format=json"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 54541,
            "updateDate": "2024-01-18 06:43:13+00:00",
            "url": "https://api.congress.gov/v3/committee-print/118/house/54541?format=json"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 54542,
            "updateDate": "2024-01-18 06:43:15+00:00",
            "url": "https://api.congress.gov/v3/committee-print/118/house/54542?format=json"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 53951,
            "updateDate": "2024-02-11 05:15:35+00:00",
            "url": "https://api.congress.gov/v3/committee-print/118/house/53951?format=json"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 53948,
            "updateDate": "2024-02-12 00:58:13+00:00",
            "url": "https://api.congress.gov/v3/committee-print/118/house/53948?format=json"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 53949,
            "updateDate": "2024-02-12 00:58:15+00:00",
            "url": "https://api.congress.gov/v3/committee-print/118/house/53949?format=json"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 53950,
            "updateDate": "2024-02-12 00:58:16+00:00",
            "url": "https://api.congress.gov/v3/committee-print/118/house/53950?format=json"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 53962,
            "updateDate": "2024-02-12 00:58:17+00:00",
            "url": "https://api.congress.gov/v3/committee-print/118/house/53962?format=json"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 54353,
            "updateDate": "2024-02-29 16:15:44+00:00",
            "url": "https://api.congress.gov/v3/committee-print/118/house/54353?format=json"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 54659,
            "updateDate": "2024-03-04 20:58:11+00:00",
            "url": "https://api.congress.gov/v3/committee-print/118/house/54659?format=json"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 54660,
            "updateDate": "2024-03-04 20:58:13+00:00",
            "url": "https://api.congress.gov/v3/committee-print/118/house/54660?format=json"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 54661,
            "updateDate": "2024-03-04 20:58:14+00:00",
            "url": "https://api.congress.gov/v3/committee-print/118/house/54661?format=json"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 54662,
            "updateDate": "2024-03-04 20:58:15+00:00",
            "url": "https://api.congress.gov/v3/committee-print/118/house/54662?format=json"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 55089,
            "updateDate": "2024-03-25 12:58:11+00:00",
            "url": "https://api.congress.gov/v3/committee-print/118/house/55089?format=json"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 55009,
            "updateDate": "2024-03-15 10:58:11+00:00",
            "url": "https://api.congress.gov/v3/committee-print/118/house/55009?format=json"
        }
    ],
    "pagination": {
        "count": 59,
        "next": "https://api.congress.gov/v3/committee-print/118?offset=20&limit=20&format=json"
    },
    "request": {
        "congress": "118",
        "contentType": "application/json",
        "format": "json"
    }
}
ryparker commented 3 months ago

@apreiter18 Would you prefer I open one issue for this and just list all the APIs that currently do not support this? Or would you rather I create a separate issue for each API like I have with

apreiter18 commented 3 months ago

@ryparker - you can create new issues if you prefer. Thanks!