List saved search matches
curl --request GET \
--url https://app.govly.com/api/enterprise/opportunities/saved_search_matches \
--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>"
}
}
],
"savedSearchMatches": [
{
"id": "<string>",
"followerEmails": [
"<string>"
],
"savedSearchName": "<string>",
"savedSearchId": "<string>",
"highlights": "<string>",
"matchedAt": "<string>"
}
]
}
],
"meta": {
"nextCursor": "<string>"
}
}Saved Searches
List saved search matches
Retrieve opportunities that match your saved searches
GET
/
api
/
enterprise
/
opportunities
/
saved_search_matches
List saved search matches
curl --request GET \
--url https://app.govly.com/api/enterprise/opportunities/saved_search_matches \
--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>"
}
}
],
"savedSearchMatches": [
{
"id": "<string>",
"followerEmails": [
"<string>"
],
"savedSearchName": "<string>",
"savedSearchId": "<string>",
"highlights": "<string>",
"matchedAt": "<string>"
}
]
}
],
"meta": {
"nextCursor": "<string>"
}
}Retrieve opportunities that match your saved searches. Results are paginated and can be filtered by date range, follower email, and saved search IDs.
Query Parameters
ISO 8601 timestamp to start searching from. Only returns matches created after this date.
ISO 8601 timestamp to search until. Only returns matches created before this date.
Filter results to specific saved searches. Multiple IDs can be provided to get matches from multiple saved searches.
Filter matches to only show opportunities from saved searches followed by this email address.
Cursor for pagination. Use the
next_cursor value from the meta object in the response to get the next page.Number of results per page (max 100)
Response
Array of opportunities with their saved search matches
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)
Array of matches between this opportunity and saved searches
Show Match properties
Show Match properties
Unique identifier for the match
List of email addresses for users following this saved search
Name of the saved search that generated this match
ID of the saved search that generated this match
Highlighted text from the opportunity that matched the saved search criteria
ISO 8601 timestamp when the match was created
Pagination metadata
Show Meta properties
Show Meta properties
Cursor to get the next page of results. Will be null if there are no more results. NOTE: We use cursor pagination instead of page numbers for this endpoint to specifically support large datasets and guarantee consistent pagination over time since matches are immutable.
⌘I