List opportunities by ID

curl --request GET \
  --url https://app.govly.com/api/enterprise/opportunities \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://app.govly.com/api/enterprise/opportunities', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.govly.com/api/enterprise/opportunities",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.govly.com/api/enterprise/opportunities"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.govly.com/api/enterprise/opportunities")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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": {}
    }
  ],
  "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>"
      }
    }
  ]
}

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>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://app.govly.com/api/enterprise/opportunities', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.govly.com/api/enterprise/opportunities",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.govly.com/api/enterprise/opportunities"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.govly.com/api/enterprise/opportunities")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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": {}
    }
  ],
  "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

string[]

Array of opportunity IDs to retrieve

Response

Returns an array of opportunity objects with detailed information about each opportunity.

string

Unique identifier for the opportunity

string

Original title from the solicitation

string

Unique identifier key for the opportunity

string

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

string

Govly web URL for viewing the opportunity

string

Direct API URL for retrieving this opportunity

string

URL to the original government source

string

ISO 8601 timestamp of when the opportunity was posted

string

ISO 8601 timestamp of the last modification

string

ISO 8601 timestamp of the response deadline

string

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

string

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

string

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

string

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

string

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

string

Contract vehicle being used for the opportunity

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.

string

AI-generated descriptive title

string

AI-generated summary of the opportunity

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

float

Minimum estimated value of the opportunity in USD

float

Maximum estimated value of the opportunity in USD

string

Description of the performance period for the opportunity

object

Structured breakdown of products and services mentioned in the opportunity

Show Properties

array

Array of product line items

Show Product Properties

string

Name of the product vendor

string

Product name

number

Quantity requested

string

Product description

string

Product part number

array

Array of service line items

Show Service Properties

string

Name of the service provider

string

Service name

number

Quantity of services

string

Service description

string

Service part number

string[]

Array of primary product names mentioned in the opportunity

object[]

Array of primary vendor information

Show Properties

string

Vendor name

string

Vendor website URL

string[]

Array of competing product names identified in the opportunity

object[]

Array of competing vendor information

Show Properties

string

Vendor name

string

Vendor website URL

string

Full opportunity description from the latest source

string

Reason for the most recent modification

string[]

Product category tags associated with the opportunity

string

Major end item from the data source context

string[]

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

string

Primary contact name

string

Primary contact email address

string

Primary contact phone number

string

Primary location address

object

Information about the buying organization

Show Properties

string

Buyer organization ID

string

Name of the buying organization

string[]

Array of organization names from highest to lowest level

string[]

Array of organization IDs corresponding to the hierarchy

object[]

Array of documents attached to the opportunity

Show Properties

string

SHA-256 checksum of the file

string

Original filename

string | null

Secure URL when the attachment is available for download

object[]

Array of source records for this opportunity

Show Properties

string

Unique identifier for the source

string

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

string

Type of record

string

Unique digest for the source content

string

URL to the original source

string

ISO 8601 timestamp when the source was created in Govly

string

ISO 8601 timestamp when the source was posted

string

ISO 8601 timestamp if a no-bid decision was recorded

boolean

Whether the source includes a justification document

boolean

Whether the source is associated with an event

string

Reason for the modification if this is an amendment

string[]

Array of checksums for attachments associated with this source

string

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

object

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

object

Additional context from the data source

Show Properties

string

Checksum of the email message if applicable

string

Original notice type from the source

string

Set-aside information from the source

Example Request

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

⌘I

Getting Started

Integrations

Enterprise

List opportunities by ID

Request

Response

Example Request

​Request

​Response

​Example Request

Request

Response

Example Request