Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

value of 'volumeCount' variable in CFR collection JSON output #32

Closed
nirmalapudota opened this issue Mar 14, 2019 · 2 comments
Closed
Assignees

Comments

@nirmalapudota
Copy link

Hi Team,

I am trying to construct the CFR-2018 section level index with the help of CFR collection API call. E.g., this API call (https://api.govinfo.gov/packages/CFR-2018-title12-vol1/summary?api_key=DEMO_KEY) provides ‘volume1’ header level information in CFR Title 12 as JSON output.
“{"title":"Banks and Banking","collectionCode":"CFR","collectionName":"Code of Federal Regulations (annual edition)","category":"Regulatory Information","dateIssued":"2018-01-01","detailsLink":"https://www.govinfo.gov/app/details/CFR-2018-title12-vol1","granulesLink":"https://api.govinfo.gov/packages/CFR-2018-title12-vol1/granules?offset=0&pageSize=100","packageId":"CFR-2018-title12-vol1","download":{"xmlLink":"https://api.govinfo.gov/packages/CFR-2018-title12-vol1/xml","pdfLink":"https://api.govinfo.gov/packages/CFR-2018-title12-vol1/pdf","txtLink":"https://api.govinfo.gov/packages/CFR-2018-title12-vol1/htm","modsLink":"https://api.govinfo.gov/packages/CFR-2018-title12-vol1/mods","premisLink":"https://api.govinfo.gov/packages/CFR-2018-title12-vol1/premis","zipLink":"https://api.govinfo.gov/packages/CFR-2018-title12-vol1/zip"},"branch":"executive","pages":"1118","governmentAuthor1":"National Archives and Records Administration","governmentAuthor2":"Office of the Federal Register","suDocClassNumber":"AE 2.106/3:12/","documentType":"CFR","titleNumber":"12","partRange":{"from":"1","to":"199"},"volumeCount":"8","publisher":"Office of the Federal Register, National Archives and Records Administration","otherIdentifier":{"migrated-doc-id":"12CFR"},"lastModified":"2018-08-03T21:54:07Z"}”

I thought the {"volumeCount":"8"} indicates the total number of volumes in CFR Title 12. But it seems not, there are total 10 volumes in Title12, here is the API link to get Volume10: https://api.govinfo.gov/packages/CFR-2018-title12-vol10/summary?api_key=DEMO_KEY.

Could you confirm what indicates the “volumeCount” key in the JSON output?

Thank you
Nirmala

@jonquandt jonquandt self-assigned this Mar 15, 2019
@jonquandt
Copy link
Member

jonquandt commented Mar 15, 2019

@nirmalapudota -

volumeCount is intended to indicate the number of volumes within a given title of the CFR for that particular year.

That metadata is derived from information in the text of the document. In this case, the volume 1 text indicates that there are eight volumes.

[[Page ix]]

                          THIS TITLE

Title 12--Banks and Banking is composed of eight volumes. The parts
in these volumes are arranged in the following order: Parts 1-199, 200-
219, 220-229, 230-299, 300-499, 500-599, part 600-899, and 900-end. The
first volume containing parts 1-199 is comprised of chapter I--
Comptroller of the Currency, Department of the Treasury. The second,
third and fourth volumes containing parts 200-299 are comprised of...

whereas the text from title 10 indicates that there are ten.

[[Page ix]]

                          THIS TITLE

Title 12--Banks and Banking is composed of ten volumes. The parts in
these volumes are arranged in the following order: Parts 1-199, 200-219,
220-229, 230-299, 300-499, 500-599, 600-899, 900-1025, 1026-1099, and
1100-end. The contents of these volumes represent all current
regulations codified under this title of the CFR as of January 1, 2018.

It appears that in the publishing process, a decision was made to further split the title into multiple volumes (i.e. from 900-end to 900-1025, 1026-1099, and 1100-end)

@nirmalapudota
Copy link
Author

got it. thank you. In order to get the correct volume count and corresponding part ranges, seems it is a good idea to construct the summary api links by increment on 'vol' string in '/CFR-2018-title12-vol10/' (https://api.govinfo.gov/packages/CFR-2018-title12-vol10/summary?api_key=DEMO_KEY.).

Thanks
Nirmala

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants