Execute a search on a saved search
curl --request GET \
--url https://app.govly.com/api/enterprise/opportunities/saved_searches/{id}/search \
--header 'X-API-KEY: <api-key>'{
"results": [
{
"id": "<string>",
"title": "<string>",
"uniqueKey": "<string>",
"externalIdentifier": "<string>",
"url": "<string>",
"apiUrl": "<string>",
"externalUrl": "<string>",
"postedAt": "<string>",
"modifiedAt": "<string>",
"respondBy": "<string>",
"questionDeadline": "<string>",
"lastSummarizedAt": "<string>",
"recordType": "<string>",
"jurisdiction": "<string>",
"isoCode": "<string>",
"contractVehicle": "<string>",
"naics": [
"<string>"
],
"aiTitle": "<string>",
"aiSummary": "<string>",
"aiShortSummary": "<string>",
"aiEstimatedValueMin": 123,
"aiEstimatedValueMax": 123,
"aiPeriodOfPerformance": "<string>",
"aiLineItems": {
"products": [
{
"vendor": "<string>",
"product": "<string>",
"quantity": 123,
"description": "<string>",
"partNumber": "<string>"
}
],
"services": [
{
"vendor": "<string>",
"service": "<string>",
"quantity": 123,
"description": "<string>",
"partNumber": "<string>"
}
]
},
"aiRawProducts": [
"<string>"
],
"aiRawVendors": [
{
"name": "<string>",
"website": "<string>"
}
],
"aiRawCompetingProducts": [
"<string>"
],
"aiRawCompetingVendors": [
{
"name": "<string>",
"website": "<string>"
}
],
"description": "<string>",
"latestModificationReason": "<string>",
"productCategoryTags": [
"<string>"
],
"majorEndItem": "<string>",
"warningTags": [
"<string>"
],
"contactName": "<string>",
"contactEmail": "<string>",
"contactPhoneNumber": "<string>",
"address": "<string>",
"buyer": {
"id": "<string>",
"name": "<string>",
"hierarchy": [
"<string>"
],
"hierarchyIds": [
"<string>"
]
},
"attachments": [
{
"checksum": "<string>",
"filename": "<string>",
"url": "<string>",
"cuiLikely": true
}
],
"sources": [
{
"id": "<string>",
"noticeType": "<string>",
"recordType": "<string>",
"digest": "<string>",
"externalUrl": "<string>",
"createdAt": "<string>",
"postedAt": "<string>",
"noBidAt": "<string>",
"hasJustification": true,
"hasEvent": true,
"modificationReason": "<string>",
"attachmentChecksums": [
"<string>"
],
"rawEmail": "<string>",
"providerContext": {},
"dataSourceContext": {
"emailMessageChecksum": "<string>",
"rawNoticeType": "<string>",
"rawSetAside": "<string>"
}
}
],
"highlights": {
"[field_name]": [
"<string>"
]
}
}
],
"meta": {
"currentPage": 123,
"per": 123,
"total": 123,
"totalPages": 123
}
}Saved Searches
Execute a search on a saved search
Search opportunities using a saved search query
GET
/
api
/
enterprise
/
opportunities
/
saved_searches
/
{id}
/
search
Execute a search on a saved search
curl --request GET \
--url https://app.govly.com/api/enterprise/opportunities/saved_searches/{id}/search \
--header 'X-API-KEY: <api-key>'{
"results": [
{
"id": "<string>",
"title": "<string>",
"uniqueKey": "<string>",
"externalIdentifier": "<string>",
"url": "<string>",
"apiUrl": "<string>",
"externalUrl": "<string>",
"postedAt": "<string>",
"modifiedAt": "<string>",
"respondBy": "<string>",
"questionDeadline": "<string>",
"lastSummarizedAt": "<string>",
"recordType": "<string>",
"jurisdiction": "<string>",
"isoCode": "<string>",
"contractVehicle": "<string>",
"naics": [
"<string>"
],
"aiTitle": "<string>",
"aiSummary": "<string>",
"aiShortSummary": "<string>",
"aiEstimatedValueMin": 123,
"aiEstimatedValueMax": 123,
"aiPeriodOfPerformance": "<string>",
"aiLineItems": {
"products": [
{
"vendor": "<string>",
"product": "<string>",
"quantity": 123,
"description": "<string>",
"partNumber": "<string>"
}
],
"services": [
{
"vendor": "<string>",
"service": "<string>",
"quantity": 123,
"description": "<string>",
"partNumber": "<string>"
}
]
},
"aiRawProducts": [
"<string>"
],
"aiRawVendors": [
{
"name": "<string>",
"website": "<string>"
}
],
"aiRawCompetingProducts": [
"<string>"
],
"aiRawCompetingVendors": [
{
"name": "<string>",
"website": "<string>"
}
],
"description": "<string>",
"latestModificationReason": "<string>",
"productCategoryTags": [
"<string>"
],
"majorEndItem": "<string>",
"warningTags": [
"<string>"
],
"contactName": "<string>",
"contactEmail": "<string>",
"contactPhoneNumber": "<string>",
"address": "<string>",
"buyer": {
"id": "<string>",
"name": "<string>",
"hierarchy": [
"<string>"
],
"hierarchyIds": [
"<string>"
]
},
"attachments": [
{
"checksum": "<string>",
"filename": "<string>",
"url": "<string>",
"cuiLikely": true
}
],
"sources": [
{
"id": "<string>",
"noticeType": "<string>",
"recordType": "<string>",
"digest": "<string>",
"externalUrl": "<string>",
"createdAt": "<string>",
"postedAt": "<string>",
"noBidAt": "<string>",
"hasJustification": true,
"hasEvent": true,
"modificationReason": "<string>",
"attachmentChecksums": [
"<string>"
],
"rawEmail": "<string>",
"providerContext": {},
"dataSourceContext": {
"emailMessageChecksum": "<string>",
"rawNoticeType": "<string>",
"rawSetAside": "<string>"
}
}
],
"highlights": {
"[field_name]": [
"<string>"
]
}
}
],
"meta": {
"currentPage": 123,
"per": 123,
"total": 123,
"totalPages": 123
}
}Request
ID of the saved search to execute
Number of results per page (max: 100)
Page number for pagination
Which date field to use for sorting. Must be one of: ‘relevance’, ‘posted_at’, ‘modified_at’ or ‘respond_by’. Default: falls back to saved search date range parameter
Sort direction for results (‘asc’ or ‘desc’, default: falls back to saved search sort direction)
Start date for filtering results (ISO 8601 format, default: 1 day ago)
End date for filtering results (ISO 8601 format, default: current date)
Which date field to use for date range filtering. Must be one of: ‘posted_at’, ‘modified_at’, or ‘respond_by’. Default: falls back to saved search date range parameter
Response
Array of opportunity objects matching the search criteria
Show Opportunity Properties
Show Opportunity Properties
Unique identifier for the opportunity
Original title from the solicitation
Unique identifier key for the opportunity
External reference number (e.g., solicitation number)
Govly web URL for viewing the opportunity
Direct API URL for retrieving this opportunity
URL to the original government source
ISO 8601 timestamp of when the opportunity was posted
ISO 8601 timestamp of the last modification
ISO 8601 timestamp of the response deadline
ISO 8601 timestamp of the deadline for submitting questions about the opportunity. Returns null when not available from the source data.
ISO 8601 timestamp of when the opportunity was last processed by AI
Type of record (e.g., “solicitation”, “forecast”, “award”)
Jurisdiction name (e.g., “United States”, “California”)
Jurisdiction ISO code (e.g., “US”, “US-CA”)
Contract vehicle being used for the opportunity
NAICS (North American Industry Classification System) codes for the opportunity. Only the most specific codes are returned (e.g., 6-digit codes are preferred over sector-level codes). Empty array if none.
AI-generated descriptive title
AI-generated summary of the opportunity
AI-generated short summary (3-6 sentences) that is concise and to the point while preserving key details like OEMs, products, quantities, and part numbers
Minimum estimated value of the opportunity in USD
Maximum estimated value of the opportunity in USD
Description of the performance period for the opportunity
Structured breakdown of products and services mentioned in the opportunity
Show Properties
Show Properties
Array of primary product names mentioned in the opportunity
Array of competing product names identified in the opportunity
Full opportunity description from the latest source
Reason for the most recent modification
Product category tags associated with the opportunity
Major end item from the data source context
Warning labels for the opportunity. Possible values:
"Brand Name or Equal", "Clearance Likely Required", "Clearance Possibly Required". Empty array if none.Primary contact name
Primary contact email address
Primary contact phone number
Primary location address
Array of source records for this opportunity
Show Properties
Show Properties
Unique identifier for the source
Type of notice (e.g., “presolicitation”, “solicitation”, “award”)
Type of record
Unique digest for the source content
URL to the original source
ISO 8601 timestamp when the source was created in Govly
ISO 8601 timestamp when the source was posted
ISO 8601 timestamp if a no-bid decision was recorded
Whether the source includes a justification document
Whether the source is associated with an event
Reason for the modification if this is an amendment
Array of checksums for attachments associated with this source
URL to the raw email if this source came from email (only visible to source owner)
Provider-specific context data (only visible to source owner)
Object containing highlighted text snippets from fields that matched the saved search criteria
Show Properties
Show Properties
Array of text snippets from the field containing highlighted matches. The field name will be the name of the field that contained matches (e.g., ‘title’, ‘description’, etc.)
⌘I