PHPackages mbagnall/gov-info - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. mbagnall/gov-info ActiveLibrary[API Development](/categories/api) mbagnall/gov-info ================= A fork for a library for using api.govinfo.gov. Compatible with Drupal 9 until it can use console 5 v0.4.1(5y ago)052MITPHPPHP >=7.2 Since Jan 16Pushed 5y agoCompare [ Source](https://github.com/ElusiveMind/gov-info)[ Packagist](https://packagist.org/packages/mbagnall/gov-info)[ Docs](https://github.com/ElusiveMind/gov-info)[ RSS](/packages/mbagnall-gov-info/feed)WikiDiscussions main Synced 5d ago READMEChangelogDependencies (2)Versions (17)Used By (0) GOVINFO: PHP library for accessing api.govinfo.gov ================================================== [](#govinfo-php-library-for-accessing-apigovinfogov) ``` _______ _______ _________ _ _______ _______ ( ____ \( ___ )|\ /| \__ __/( ( /|( ____ \( ___ ) | ( \/| ( ) || ) ( | ) ( | \ ( || ( \/| ( ) | | | | | | || | | | | | | \ | || (__ | | | | | | ____ | | | |( ( ) ) | | | (\ \) || __) | | | | | | \_ )| | | | \ \_/ / | | | | \ || ( | | | | | (___) || (___) | \ / ___) (___| ) \ || ) | (___) | (_______)(_______) \_/ \_______/|/ )_)|/ (_______) ``` [![CircleCI](https://camo.githubusercontent.com/715a9246f11bf80614f9554ee57fee77b05dcecba330ad0224ff5fb712988fee/68747470733a2f2f636972636c6563692e636f6d2f67682f636e697a7a617264696e692f676f762d696e666f2f747265652f6d61737465722e7376673f7374796c653d737667)](https://circleci.com/gh/cnizzardini/gov-info/tree/master)[![Maintainability](https://camo.githubusercontent.com/28aa9fbaa189802b1bb3a8b3f620a4b6cc11c14c25b71fae590bb3fff6bb754c/68747470733a2f2f6170692e636f6465636c696d6174652e636f6d2f76312f6261646765732f35353733343835386233623935343262346266662f6d61696e7461696e6162696c697479)](https://codeclimate.com/github/cnizzardini/gov-info/maintainability)[![Test Coverage](https://camo.githubusercontent.com/e43c20a87f02a44fce8a919d7fb390a7bb485b3d58630da5d57faec93730569b/68747470733a2f2f6170692e636f6465636c696d6174652e636f6d2f76312f6261646765732f35353733343835386233623935343262346266662f746573745f636f766572616765)](https://codeclimate.com/github/cnizzardini/gov-info/test_coverage)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md) This alpha stage package provides a very simple way to access [api.govinfo.gov](https://api.govinfo.gov/docs/) [See console demo](#Console) Install ------- [](#install) You can install this package via composer. ``` composer require cnizzardini/gov-info ``` Usage ----- [](#usage) Retrieve an index of all collections available ``` use GovInfo\Api; use GovInfo\Collection; $api = new Api( new \GuzzleHttp\Client(), 'DEMO_KEY' ); $collection = new Collection($api); $result = $collection->index(); ``` After running this code `$result` will contain a non-truncated version of collections: ``` Array ( [collections] => Array [ [0] => Array [ [collectionCode] => USCOURTS [collectionName] => United States Courts Opinions [packageCount] => 1134933 [granuleCount] => 2525240 ] ... ) ``` Retrieve all packages in a collection ``` use GovInfo\Api; use GovInfo\Collection; use GovInfo\Requestor\CollectionAbstractRequestor; $api = new Api( new \GuzzleHttp\Client(), 'DEMO_KEY' ); $collection = new Collection($api); $requestor = new CollectionAbstractRequestor(); $requestor ->setStrCollectionCode('BILLS') ->setObjStartDate(new DateTime('2019-01-01')); $result = $collection->item($requestor); ``` After running this code `$result` will contain a non-truncated version of packages: ``` Array ( [count] => 202767 [message] => [nextPage] => https://api.govinfo.gov/collections/BILLS/2018-01-01T00:00:00Z/?offset=100&pageSize=100 [previousPage] => [packages] => Array [ [0] => Array [ [packageId] => BILLS-115hr2740rfs [lastModified] => 2018-11-16T00:33:17Z [packageLink] => https://api.govinfo.gov/packages/BILLS-115hr2740rfs/summary [docClass] => hr [title] => Rabbi Michoel Ber Weissmandl Congressional Gold Medal Act of 2017 ] ... ``` Retrieve a specific package in a collection. ``` use GovInfo\Api; use GovInfo\Collection; use GovInfo\Requestor\CollectionAbstractRequestor; $api = new Api( new \GuzzleHttp\Client(), 'DEMO_KEY' ); $collection = new Collection($api); $requestor = new CollectionAbstractRequestor(); $requestor ->setStrCollectionCode('BILLS') ->setObjStartDate(new \DateTime('2018-01-01 12:00:00')) ->setObjEndDate(new \DateTime('2018-02-01 12:00:00')) ->setStrDocClass('hr') ->setStrPackageId('BILLS-115hr4033rfs') ->setStrTitle('Geologic Mapping Act'); $result = $collection->item($requestor); ``` After running this code `$result` will contain the requested package ``` Array ( [count] => 202767 [message] => [nextPage] => https://api.govinfo.gov/collections/BILLS/2018-01-01T00:00:00Z/?offset=100&pageSize=100 [previousPage] => [packages] => Array [ [2] => Array [ [packageId] => BILLS-115hr4033rfs [lastModified] => 2018-11-16T00:33:00Z [packageLink] => https://api.govinfo.gov/packages/BILLS-115hr4033rfs/summary [docClass] => hr [title] => National Geologic Mapping Act Reauthorization Act ] ] ) ``` Retrieve a summary of a package. ``` use GovInfo\Package; use GovInfo\Requestor\PackageAbstractRequestor; $package = new Package($api); $requestor = new PackageAbstractRequestor(); $result = $package->summary($requestor->setStrPackageId('BILLS-115hr4033rfs')); ``` After running this code `$result` will contain a non-truncated version of the package summary ``` Array ( [title] => An Act To reauthorize the National Geologic Mapping Act of 1992. [shortTitle] => Array [ [0] => Array [ [type] => measure [title] => National Geologic Mapping Act Reauthorization Act ] ] ... ``` Retrieve a package as a specified content-type ``` use GovInfo\Package; use GovInfo\Requestor\PackageAbstractRequestor; $package = new Package($api); $requestor = new PackageAbstractRequestor(); $requestor ->setStrPackageId('BILLS-115hr4033rfs') ->setStrContentType('xml'); $result = $package->contentType($requestor); ``` After running this code `$result` will be an instance of GuzzleHttp\\Psr7\\Response For additional usage examples, please look at `src/Console` and `tests`. Console ------- [](#console) There is a minimalist console application that *can* be used, but its not designed for production use. I built this so I could easily regression test the library against the production API. Each command will prompt you for an API key. To avoid this prompt you can create a local `apiKey.txt` file with your API key in there. [![Example](./docs/console-demo.svg)](./docs/console-demo.svg) ``` # displays collections php console.php collection:index # display packages for a given collection php console.php collection:packages # writes to csv file php console.php collection:packages --file # writes to csv file in a specific folder php console.php collection:packages --file --path=/home/username/Desktop # retrieves a package summary as a GuzzleHttp\Psr7\Response instance php console.php package:summary # retrieves a package summary and writes to file php console.php package:summary --file # writes to file in a specific folder php console.php collection:packages --file --path=/home/username/Desktop ``` Testing ------- [](#testing) ``` vendor/bin/phpunit ``` License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 24 — LowBetter than 32% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity8 Limited adoption so far Community8 Small or concentrated contributor base Maturity50 Maturing project, gaining track record Bus Factor1 Top contributor holds 94.2% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~31 days Recently: every ~4 days Total 14 Last Release 1912d ago PHP version history (2 changes)v0.1PHP ^7.2 v0.4.1PHP >=7.2 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/1769950?v=4)[Martin Bagnall](/maintainers/mbagnall)[@mbagnall](https://github.com/mbagnall) --- Top Contributors [![cnizzardini](https://avatars.githubusercontent.com/u/171294?v=4)](https://github.com/cnizzardini "cnizzardini (162 commits)")[![ElusiveMind](https://avatars.githubusercontent.com/u/195676?v=4)](https://github.com/ElusiveMind "ElusiveMind (10 commits)") --- Tags govgovinfogovinfo.govapi.govinfo.gov ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/mbagnall-gov-info/health.svg) ``` [![Health](https://phpackages.com/badges/mbagnall-gov-info/health.svg)](https://phpackages.com/packages/mbagnall-gov-info) ``` ### Alternatives [tencentcloud/tencentcloud-sdk-php TencentCloudApi php sdk 3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[convertkit/convertkitapi Kit PHP SDK for the Kit API 2167.1k1](/packages/convertkit-convertkitapi)[mapado/rest-client-sdk Rest Client SDK for hydra API 1125.9k2](/packages/mapado-rest-client-sdk) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)