Skip to main content
POST
Create an award saved search

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
name
string
required

Display name for the saved search.

query
string

Free-text search terms.

searchType
enum<string>

Market this search covers. Defaults to the caller's market focus and is stored, so it bounds every later replay.

Available options:
fed,
sled,
international
recipientNames
string[]

Recipient/vendor names to filter by.

buyerNames
string[]

Awarding buyer names.

funderNames
string[]

Funding agency names.

naics
string[]

NAICS codes to filter by.

psc
string[]

Product/service codes.

amountRange
number[]

[min, max] awarded amount.

Required array length: 2 elements
placeIds
string[]

Canonical Govly Place ids to scope the saved search to, from the place search or list tools. Matches at any administrative level. Bounded by the stored market, and changeable but not removable.

placeIdsNone
string[]

Canonical Govly Place ids to exclude. Same matching rules as placeIds.

dateRangeParam
string

Which award date field the relative window applies to.

relativeStartDayPivot
integer

Window start, in days relative to today. Defaults to -365.

relativeEndDayPivot
integer

Window end, in days relative to today. Defaults to 0.

Response

Created award saved search

data
object
required