search

LibraryOfCongress / api.congress.gov

congress.gov API
601 stars 38 forks source link

(hearing): sort by `updateDate` #215

Open ryparker opened 3 months ago

ryparker commented 3 months ago

The hearing 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/hearing/118?format=json&api_key=<API_KEY>'

Response:

{
    "hearings": [
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 52524,
            "updateDate": "2024-03-26T17:08:16Z",
            "url": "https://api.congress.gov/v3/hearing/118/house/52524"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 52888,
            "updateDate": "2024-03-26T17:08:16Z",
            "url": "https://api.congress.gov/v3/hearing/118/house/52888"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 52171,
            "updateDate": "2024-03-26T17:08:14Z",
            "url": "https://api.congress.gov/v3/hearing/118/house/52171"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 52731,
            "updateDate": "2024-03-23T00:49:24Z",
            "url": "https://api.congress.gov/v3/hearing/118/house/52731"
        },
        {
            "chamber": "Senate",
            "congress": 118,
            "jacketNumber": 52759,
            "number": 43,
            "updateDate": "2024-03-26T17:08:14Z",
            "url": "https://api.congress.gov/v3/hearing/118/senate/52759"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 53047,
            "updateDate": "2024-03-26T02:34:37Z",
            "url": "https://api.congress.gov/v3/hearing/118/house/53047"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 54350,
            "updateDate": "2024-03-23T00:49:24Z",
            "url": "https://api.congress.gov/v3/hearing/118/house/54350"
        },
        {
            "chamber": "Senate",
            "congress": 118,
            "jacketNumber": 52110,
            "number": 11,
            "updateDate": "2024-03-26T01:04:35Z",
            "url": "https://api.congress.gov/v3/hearing/118/senate/52110"
        },
        {
            "chamber": "Senate",
            "congress": 118,
            "jacketNumber": 52837,
            "number": 50,
            "updateDate": "2024-03-26T02:19:34Z",
            "url": "https://api.congress.gov/v3/hearing/118/senate/52837"
        },
        {
            "chamber": "NoChamber",
            "congress": 118,
            "jacketNumber": 53003,
            "updateDate": "2024-03-26T01:49:27Z",
            "url": "https://api.congress.gov/v3/hearing/118/nochamber/53003"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 53204,
            "updateDate": "2024-03-26T02:19:34Z",
            "url": "https://api.congress.gov/v3/hearing/118/house/53204"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 52826,
            "updateDate": "2024-03-26T02:19:33Z",
            "url": "https://api.congress.gov/v3/hearing/118/house/52826"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 51683,
            "updateDate": "2024-03-26T02:34:37Z",
            "url": "https://api.congress.gov/v3/hearing/118/house/51683"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 52562,
            "updateDate": "2024-03-26T02:19:33Z",
            "url": "https://api.congress.gov/v3/hearing/118/house/52562"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 52867,
            "updateDate": "2024-03-26T17:08:16Z",
            "url": "https://api.congress.gov/v3/hearing/118/house/52867"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 54496,
            "updateDate": "2024-03-23T00:49:23Z",
            "url": "https://api.congress.gov/v3/hearing/118/house/54496"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 53338,
            "updateDate": "2024-03-23T00:49:23Z",
            "url": "https://api.congress.gov/v3/hearing/118/house/53338"
        },
        {
            "chamber": "House",
            "congress": 118,
            "jacketNumber": 52650,
            "updateDate": "2024-03-23T00:49:23Z",
            "url": "https://api.congress.gov/v3/hearing/118/house/52650"
        },
        {
            "chamber": "Senate",
            "congress": 118,
            "jacketNumber": 52706,
            "number": 37,
            "updateDate": "2024-03-23T00:49:24Z",
            "url": "https://api.congress.gov/v3/hearing/118/senate/52706"
        },
        {
            "chamber": "Senate",
            "congress": 118,
            "jacketNumber": 53706,
            "number": 134,
            "updateDate": "2024-03-23T01:04:23Z",
            "url": "https://api.congress.gov/v3/hearing/118/senate/53706"
        }
    ],
    "pagination": {
        "count": 641,
        "next": "https://api.congress.gov/v3/hearing/118?offset=20&limit=20&format=json"
    },
    "request": {
        "congress": "118",
        "contentType": "application/json",
        "format": "json"
    }
}