Skip to content

Search contracts

Request

Use this to find contracts and solicitations by keyword, place, buyer, code, value or due date. Returns one page of contracts with the true total across every page. Uncapped for every key; your plan only sets how far back the archive reaches.

Security
bearerKey
Query
qstring
jurisdictionArray of strings
buyerTypeArray of strings
setAsideArray of strings
opportunityKindArray of strings
personasArray of strings
buyerClassArray of strings
naicsArray of strings
pscArray of strings
categorystring
tagArray of strings
typestring
recordTypeArray of strings
statusstring
Enum:"open""closing_soon""closed"
minValuenumber
maxValuenumber
dueBeforestring, (date)
dueAfterstring, (date)
postedAfterstring, (date)
firstSeenAfterstring, (date)
windowstring
commercialCategorystring
includePastDueboolean
includeArchivedboolean
sortstring
Enum:"relevance""fit""recent""deadline""value_desc""value_asc"
pageinteger
limitinteger
curl -i -X GET \
  https://docs.societyhealth.co/_mock/docs/openapi/api/v1/contracts \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

The requested page, with the true total across all pages.

Bodyapplication/json
okanyrequired
Value:true
dataArray of objects(PublicContract)required
pageinteger
totalinteger
Response
{ "ok": true, "data": [ { … } ], "page": 1, "total": 1 }