Skip to main content
GET
/
api
/
enterprise
/
opportunities
List opportunities by ID
curl --request GET \
  --url https://app.govly.com/api/enterprise/opportunities \
  --header 'X-API-KEY: <api-key>'
{
  "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>"
      }
    }
  ]
}

​
Request

​
ids[]
string[]
Array of opportunity IDs to retrieve

​
Response

Returns an array of opportunity objects with detailed information about each opportunity.
​
id
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
​
aiRawProducts
string[]
Array of primary product names mentioned in the opportunity
​
aiRawVendors
object[]
Array of primary vendor information
​
aiRawCompetingProducts
string[]
Array of competing product names identified in the opportunity
​
aiRawCompetingVendors
object[]
Array of competing vendor information
​
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
​
attachments
object[]
Array of documents attached to the opportunity
​
sources
object[]
Array of source records for this opportunity

​
Example Request

curl "https://api.govly.com/api/enterprise/opportunities?ids[]=13887036"