POST
/
api
/
v3
/
opportunities
/
filter
Filter Opportunities
curl --request POST \
  --url https://app.govly.com/api/v3/opportunities/filter \
  --header 'Content-Type: application/json' \
  --data '{
  "dateRangeParam": "<string>",
  "dateRange": [
    "<string>"
  ],
  "contractVehicleIds": [
    "<string>"
  ],
  "page": 123,
  "per": 123,
  "sort": "<string>",
  "sortDirection": "<string>"
}'
This endpoint filters searchable opportunities. By default, it returns a maximum of 10,000 results in pages of 500.

​
Request Body

​
dateRangeParam
string
Can be one of: “posted_at” (default), “modified_at”, or “respond_by”
​
dateRange
string[]
An array of ISO 8601 formatted strings: [startTime, endTime]
​
contractVehicleIds
string[]
List of contract vehicle IDs to filter by
​
page
integer
Page number for pagination (default: 1)
​
per
integer
Results per page
​
sort
string
Can be one of: “posted” (default), “modified”, or “expires”
​
sortDirection
string
Can be one of: “asc” or “desc” (default)
This endpoint is part of the legacy v3 API and will be deprecated in the future. Please migrate to the new enterprise API endpoints.