gov tool
Publicgov_search_recipients
Resolve a federal-award recipient name, UEI, or recipient id.
Description
Resolve a federal-award recipient name, UEI, or recipient id.
Returns a shared envelope with the echoed query and ranked matches,
including recipient/UEI/DUNS identifiers, USAspending recipient level,
parent linkage, score, match reason, and as_of. Search is bounded to
10 matches by default and 50 maximum; pagination is null. Empty input
is bad_parameter; no match is unknown_entity and can carry up to
three did-you-mean suggestions.
Pass an exact match to gov_get_recipient_awards for fiscal-year totals.
Example: gov_search_recipients(query="Lockheed Martin", limit=5).
Parameters
Input schema
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| query | string | Yes | — | Recipient canonical or alternate name, 12-character UEI, or exact USAspending recipient_id. Use this first to resolve a name for gov_get_recipient_awards. |
| limit | integer | No | 10 | Maximum ranked recipient matches (1–50). |
Provenance
Sources
- usaspendingU.S. Department of the Treasury, USAspending.gov
Dataset registry: gov_recipient_awards