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>"
  }
}

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

startDate

string

ISO 8601 timestamp to start searching from. Only returns matches created after this date.

endDate

string

ISO 8601 timestamp to search until. Only returns matches created before this date.

savedSearchIds

string[]

Filter results to specific saved searches. Multiple IDs can be provided to get matches from multiple saved searches.

followerEmails

string[]

Filter matches to only show opportunities from saved searches followed by this email address.

cursor

string

Cursor for pagination. Use the next_cursor value from the meta object in the response to get the next page.

per

integer

default:"50"

Number of results per page (max 100)

Response

results

array

Array of opportunities with their saved search matches

Show Opportunity properties

string

Unique identifier for the opportunity

title

string

Original title from the solicitation

uniqueKey

string

Unique identifier key for the opportunity

externalIdentifier

string

External reference number (e.g., solicitation number)

url

string

Govly web URL for viewing the opportunity

apiUrl

string

Direct API URL for retrieving this opportunity

externalUrl

string

URL to the original government source

postedAt

string

ISO 8601 timestamp of when the opportunity was posted

modifiedAt

string

ISO 8601 timestamp of the last modification

respondBy

string

ISO 8601 timestamp of the response deadline

questionDeadline

string

ISO 8601 timestamp of the deadline for submitting questions about the opportunity. Returns null when not available from the source data.

lastSummarizedAt

string

ISO 8601 timestamp of when the opportunity was last processed by AI

recordType

string

Type of record (e.g., “solicitation”, “forecast”, “award”)

jurisdiction

string

Jurisdiction name (e.g., “United States”, “California”)

isoCode

string

Jurisdiction ISO code (e.g., “US”, “US-CA”)

contractVehicle

string

Contract vehicle being used for the opportunity

naics

string[]

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.

aiTitle

string

AI-generated descriptive title

aiSummary

string

AI-generated summary of the opportunity

aiShortSummary

string

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

aiEstimatedValueMin

float

Minimum estimated value of the opportunity in USD

aiEstimatedValueMax

float

Maximum estimated value of the opportunity in USD

aiPeriodOfPerformance

string

Description of the performance period for the opportunity

aiLineItems

object

Structured breakdown of products and services mentioned in the opportunity

Show Properties

products

array

Array of product line items

Show Product Properties

vendor

string

Name of the product vendor

product

string

Product name

quantity

number

Quantity requested

description

string

Product description

partNumber

string

Product part number

services

array

Array of service line items

Show Service Properties

vendor

string

Name of the service provider

service

string

Service name

quantity

number

Quantity of services

description

string

Service description

partNumber

string

Service part number

aiRawProducts

string[]

Array of primary product names mentioned in the opportunity

aiRawVendors

object[]

Array of primary vendor information

Show Properties

name

string

Vendor name

website

string

Vendor website URL

aiRawCompetingProducts

string[]

Array of competing product names identified in the opportunity

aiRawCompetingVendors

object[]

Array of competing vendor information

Show Properties

name

string

Vendor name

website

string

Vendor website URL

description

string

Full opportunity description from the latest source

latestModificationReason

string

Reason for the most recent modification

productCategoryTags

string[]

Product category tags associated with the opportunity

majorEndItem

string

Major end item from the data source context

warningTags

string[]

Warning labels for the opportunity. Possible values: "Brand Name or Equal", "Clearance Likely Required", "Clearance Possibly Required". Empty array if none.

contactName

string

Primary contact name

contactEmail

string

Primary contact email address

contactPhoneNumber

string

Primary contact phone number

address

string

Primary location address

buyer

object

Information about the buying organization

Show Properties

string

Buyer organization ID

name

string

Name of the buying organization

hierarchy

string[]

Array of organization names from highest to lowest level

hierarchyIds

string[]

Array of organization IDs corresponding to the hierarchy

attachments

object[]

Array of documents attached to the opportunity

Show Properties

checksum

string

SHA-256 checksum of the file

filename

string

Original filename

url

string

Secure URL to download the attachment

cuiLikely

boolean

Whether the attachment likely contains Controlled Unclassified Information (CUI)

sources

object[]

Array of source records for this opportunity

Show Properties

string

Unique identifier for the source

noticeType

string

Type of notice (e.g., “presolicitation”, “solicitation”, “award”)

recordType

string

Type of record

digest

string

Unique digest for the source content

externalUrl

string

URL to the original source

createdAt

string

ISO 8601 timestamp when the source was created in Govly

postedAt

string

ISO 8601 timestamp when the source was posted

noBidAt

string

ISO 8601 timestamp if a no-bid decision was recorded

hasJustification

boolean

Whether the source includes a justification document

hasEvent

boolean

Whether the source is associated with an event

modificationReason

string

Reason for the modification if this is an amendment

attachmentChecksums

string[]

Array of checksums for attachments associated with this source

rawEmail

string

URL to the raw email if this source came from email (only visible to source owner)

providerContext

object

Provider-specific context data (only visible to source owner)

dataSourceContext

object

Additional context from the data source

Show Properties

emailMessageChecksum

string

Checksum of the email message if applicable

rawNoticeType

string

Original notice type from the source

rawSetAside

string

Set-aside information from the source

savedSearchMatches

array

Array of matches between this opportunity and saved searches

Show Match properties

string

Unique identifier for the match

followerEmails

string[]

List of email addresses for users following this saved search

savedSearchName

string

Name of the saved search that generated this match

savedSearchId

string

ID of the saved search that generated this match

highlights

string

Highlighted text from the opportunity that matched the saved search criteria

matchedAt

string

ISO 8601 timestamp when the match was created

Getting Started

Enterprise

List saved search matches

Query Parameters

Response

Getting Started

Enterprise

Documentation Index

​Query Parameters

​Response

Query Parameters

Response