usaspending-api icon indicating copy to clipboard operation
usaspending-api copied to clipboard

Ability to retrieve associated offices for each sub-agency

Open nhinze opened this issue 6 years ago • 2 comments

This is a new feature suggestion. The ability to retrieve the offices by sub-agency. Essentially, adding another sub-tier to the autocomplete for agencies and the /bulk_download/list_agencies/ end point.

nhinze avatar Jul 22 '19 11:07 nhinze

Thank you for the feature suggestion. We have passed on the feedback to the team for evaluation. The progress for this request can be followed here: https://federal-spending-transparency.atlassian.net/browse/DEV-3161.

lisaam avatar Jul 23 '19 20:07 lisaam

This is a great idea.

Unfortunately, in our estimation, it would violate the terms of use of the Federal Hierarchy API under which we receive the office information. They state:

"You are allowed to use the Federal Hierarchy FOUO API for internal, U.S. Government business purposes. You are not allowed to display or disseminate outside the U.S. Government any values received in a Federal Hierarchy FOUO API response unless that value is directly associated with a Federal award record. [...] You may not use the Federal Hierarchy FOUO API to build out a public view of either the partial or complete Federal Hierarchy. You must use the Federal Hierarchy Public API if you wish to display or disseminate the public-facing Department and Sub-Tier information."

Unfortunately, the Federal Hierarchy is the only source of the office-level information at present.

If you have any questions or suggestions related to these terms of use, please contact the General Services Administration, Integrated Award Environment.

ross-williford avatar Dec 19 '19 03:12 ross-williford