Getting Started
Enterprise
- Onboarding
- Enterprise API Reference
- Legacy API Reference (v2/v3)
List Saved Searches
Returns a paginated list of saved opportunity searches for your organization
curl --request GET \
--url https://app.govly.com/api/enterprise/opportunities/saved_searches \
--header 'X-API-KEY: <api-key>'
{
"results": [
{
"id": "<string>",
"active": true,
"createdAt": "<string>",
"createdByEmail": "<string>",
"lastMatchedAt": "<string>",
"matchCount": 123,
"name": "<string>",
"query": {
"sortDirection": "<string>",
"feeds": [
{}
],
"query": "<string>",
"status": [
{}
],
"buyerIds": [
{}
],
"recordType": [
{}
],
"excludeIgnored": [
{}
],
"dateRangeParam": "<string>",
"buyerMatchById": true,
"includeSubBuyers": true,
"predictions": true,
"searchType": "<string>",
"searchFields": {}
},
"updatedAt": "<string>"
}
],
"meta": {
"currentPage": 123,
"per": 123,
"total": 123,
"totalPages": 123
}
}
Request
Page number for pagination
Number of results per page
Response
Array of saved search objects
Unique identifier for the saved search
Whether the saved search is currently active
ISO 8601 timestamp when the saved search was created
Email of the user who created the saved search
ISO 8601 timestamp when the saved search last found a matching opportunity
Number of opportunities matching the saved search
Name of the saved search
Search criteria configuration
Field to sort results by
List of contract vehicle feeds to search
Search query string
List of opportunity statuses to include
List of buyer IDs to filter by
Types of records to include
Direction to sort results (asc
or desc
)
List of opportunity IDs to exclude
Field to use for date filtering
Whether to match buyers by ID
Whether to include sub-organizations of matched buyers
Whether to include AI-predicted opportunities
Type of search to perform
Configuration for field-specific search options
ISO 8601 timestamp when the saved search was last updated
curl --request GET \
--url https://app.govly.com/api/enterprise/opportunities/saved_searches \
--header 'X-API-KEY: <api-key>'
{
"results": [
{
"id": "<string>",
"active": true,
"createdAt": "<string>",
"createdByEmail": "<string>",
"lastMatchedAt": "<string>",
"matchCount": 123,
"name": "<string>",
"query": {
"sortDirection": "<string>",
"feeds": [
{}
],
"query": "<string>",
"status": [
{}
],
"buyerIds": [
{}
],
"recordType": [
{}
],
"excludeIgnored": [
{}
],
"dateRangeParam": "<string>",
"buyerMatchById": true,
"includeSubBuyers": true,
"predictions": true,
"searchType": "<string>",
"searchFields": {}
},
"updatedAt": "<string>"
}
],
"meta": {
"currentPage": 123,
"per": 123,
"total": 123,
"totalPages": 123
}
}