POST
/
api
/
v3
/
opportunities
/
filter
curl --request POST \
  --url https://app.govly.com/api/v3/opportunities/filter \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --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.