Skip to main content
POST
Search awards

Authorizations

Authorization
string
header
required

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

Body

application/json
query
string

Search text. Supports keywords, quoted phrases, and boolean operators such as AND, OR, and NOT.

cursor
string

Opaque pagination token from the previous response's meta.nextCursor. Omit for the first page. Tokens are bound to the query, filters, and sort inputs and carry no format guarantee.

perPage
integer
default:25
Required range: x <= 100
searchType
enum<string>

Market type. Defaults to the authenticated user's market focus (fed or sled). sled and international require the matching organization subscription.

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

Filter by award action dates as [start, end] in ISO 8601 format. Searches all time when omitted.

Required array length: 2 elements
recipientNames
string[]

Filter to awards won by any of these recipient (vendor) names.

buyerNames
string[]

Filter to awards bought by any of these government buyer names.

funderNames
string[]

Filter to awards funded by any of these government funder names.

naics
string[]

NAICS codes to filter by, such as 334111.

psc
string[]

Product or service codes (PSC) to filter by.

amountRange
number[]

Filter by award amount as [minimum, maximum].

Required array length: 2 elements
sort
enum<string>

Sort field. Defaults to period_of_performance_start_date. Use awarded_date for recency or award_amount for contract size. SLED awards often lack period_of_performance_start_date, so prefer awarded_date when searchType is sled.

Available options:
period_of_performance_start_date,
awarded_date,
last_modified_date,
award_amount
sortDirection
enum<string>
Available options:
asc,
desc

Response

Matching awards

data
object[]
required
meta
object
required