List awards
curl --request GET \
--url https://app.govly.com/api/enterprise/awards \
--header 'X-API-KEY: <api-key>'import requests
url = "https://app.govly.com/api/enterprise/awards"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://app.govly.com/api/enterprise/awards', 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/awards",
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/awards"
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))
}HttpResponse<String> response = Unirest.get("https://app.govly.com/api/enterprise/awards")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.govly.com/api/enterprise/awards")
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{
"results": [
{
"id": "<string>",
"uniqueKey": "<string>",
"identifier": "<string>",
"title": "<string>",
"description": "<string>",
"aiSummary": "<string>",
"category": "<string>",
"url": "<string>",
"externalUrl": "<string>",
"awardedDate": "<string>",
"lastModifiedDate": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>",
"externalSolicitationDate": "<string>",
"periodOfPerformanceStartDate": "<string>",
"periodOfPerformanceEndDate": "<string>",
"periodOfPerformancePotentialEndDate": "<string>",
"awardAmount": 123,
"ceilingAmount": 123,
"obligatedAmount": 123,
"paidAmount": 123,
"paymentStructure": "<string>",
"acquisitionType": "<string>",
"acquisitionCategory": "<string>",
"extentCompeted": "<string>",
"naics": "<string>",
"psc": "<string>",
"numberOfBidsReceived": 123,
"setAside": {
"code": "<string>",
"name": "<string>"
},
"parentUniqueKey": "<string>",
"externalParentIdentifier": "<string>",
"externalSolicitationId": "<string>",
"recipientUniqueKey": "<string>",
"recipientParentUniqueKey": "<string>",
"recipientCageCode": "<string>",
"recipient": {
"uniqueKey": "<string>",
"name": "<string>",
"cageCode": "<string>",
"address": {
"streetAddress": "<string>",
"streetAddress2": "<string>",
"streetAddress3": "<string>",
"city": "<string>",
"region": "<string>",
"postalCode": "<string>",
"country": "<string>"
},
"aiHqAddress": {},
"aiUrl": "<string>"
},
"buyer": {
"id": "<string>",
"name": "<string>",
"hierarchy": [
"<string>"
],
"hierarchyIds": [
"<string>"
],
"aiUrl": "<string>",
"aiHqAddress": {}
},
"buyingOffice": {
"id": "<string>",
"name": "<string>",
"hierarchy": [
"<string>"
],
"hierarchyIds": [
"<string>"
],
"aiUrl": "<string>",
"aiHqAddress": {}
},
"funder": {
"id": "<string>",
"name": "<string>",
"hierarchy": [
"<string>"
],
"hierarchyIds": [
"<string>"
],
"aiUrl": "<string>",
"aiHqAddress": {}
},
"fundingOffice": {
"id": "<string>",
"name": "<string>",
"hierarchy": [
"<string>"
],
"hierarchyIds": [
"<string>"
],
"aiUrl": "<string>",
"aiHqAddress": {}
},
"placeOfManufacture": "<string>",
"placeOfPerformance": {
"city": "<string>",
"region": "<string>",
"postalCode": "<string>",
"country": "<string>",
"county": "<string>",
"congressionalCode": "<string>"
}
}
],
"meta": {
"nextCursor": "<string>",
"pageSize": 123,
"startDate": "<string>",
"endDate": "<string>"
}
}Awards
List awards
Retrieve federal contract awards with filtering by date range, unique key, or recipient
GET
/
api
/
enterprise
/
awards
List awards
curl --request GET \
--url https://app.govly.com/api/enterprise/awards \
--header 'X-API-KEY: <api-key>'import requests
url = "https://app.govly.com/api/enterprise/awards"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://app.govly.com/api/enterprise/awards', 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/awards",
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/awards"
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))
}HttpResponse<String> response = Unirest.get("https://app.govly.com/api/enterprise/awards")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.govly.com/api/enterprise/awards")
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{
"results": [
{
"id": "<string>",
"uniqueKey": "<string>",
"identifier": "<string>",
"title": "<string>",
"description": "<string>",
"aiSummary": "<string>",
"category": "<string>",
"url": "<string>",
"externalUrl": "<string>",
"awardedDate": "<string>",
"lastModifiedDate": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>",
"externalSolicitationDate": "<string>",
"periodOfPerformanceStartDate": "<string>",
"periodOfPerformanceEndDate": "<string>",
"periodOfPerformancePotentialEndDate": "<string>",
"awardAmount": 123,
"ceilingAmount": 123,
"obligatedAmount": 123,
"paidAmount": 123,
"paymentStructure": "<string>",
"acquisitionType": "<string>",
"acquisitionCategory": "<string>",
"extentCompeted": "<string>",
"naics": "<string>",
"psc": "<string>",
"numberOfBidsReceived": 123,
"setAside": {
"code": "<string>",
"name": "<string>"
},
"parentUniqueKey": "<string>",
"externalParentIdentifier": "<string>",
"externalSolicitationId": "<string>",
"recipientUniqueKey": "<string>",
"recipientParentUniqueKey": "<string>",
"recipientCageCode": "<string>",
"recipient": {
"uniqueKey": "<string>",
"name": "<string>",
"cageCode": "<string>",
"address": {
"streetAddress": "<string>",
"streetAddress2": "<string>",
"streetAddress3": "<string>",
"city": "<string>",
"region": "<string>",
"postalCode": "<string>",
"country": "<string>"
},
"aiHqAddress": {},
"aiUrl": "<string>"
},
"buyer": {
"id": "<string>",
"name": "<string>",
"hierarchy": [
"<string>"
],
"hierarchyIds": [
"<string>"
],
"aiUrl": "<string>",
"aiHqAddress": {}
},
"buyingOffice": {
"id": "<string>",
"name": "<string>",
"hierarchy": [
"<string>"
],
"hierarchyIds": [
"<string>"
],
"aiUrl": "<string>",
"aiHqAddress": {}
},
"funder": {
"id": "<string>",
"name": "<string>",
"hierarchy": [
"<string>"
],
"hierarchyIds": [
"<string>"
],
"aiUrl": "<string>",
"aiHqAddress": {}
},
"fundingOffice": {
"id": "<string>",
"name": "<string>",
"hierarchy": [
"<string>"
],
"hierarchyIds": [
"<string>"
],
"aiUrl": "<string>",
"aiHqAddress": {}
},
"placeOfManufacture": "<string>",
"placeOfPerformance": {
"city": "<string>",
"region": "<string>",
"postalCode": "<string>",
"country": "<string>",
"county": "<string>",
"congressionalCode": "<string>"
}
}
],
"meta": {
"nextCursor": "<string>",
"pageSize": 123,
"startDate": "<string>",
"endDate": "<string>"
}
}Request
At least one filter is required:start_date, unique_keys[], or recipient_ueis[].
Date Range Filtering
string
Start date for filtering awards by last modified date (ISO 8601 format, e.g., “2024-01-15”). Required unless filtering by
unique_keys[] or recipient_ueis[].string
End date for filtering awards by last modified date (ISO 8601 format). Defaults to 7 days after
start_date if not provided. Maximum date range is 7 days.Identifier Filtering
string[]
Array of award unique keys (e.g., FPDS PIID) to retrieve. Maximum 100 values. When provided,
start_date is not required.string[]
Array of recipient UEIs to filter by. Maximum 100 values. When provided,
start_date is not required.Pagination
integer
default:100
Number of results per page. Maximum: 100.
string
Base64-encoded cursor for pagination. Use the
nextCursor value from the previous response to get the next page of results.Response
Returns an array of award objects with pagination metadata.array
Array of award objects
Show Award Properties
Show Award Properties
string
Unique identifier for the award
string
Unique identifier key for the award (e.g., FPDS PIID)
string
External identifier for the award
string
Title of the award
string
Description of the award
string
AI-generated summary of the award
string
Award category (e.g., “contract”, “grant”)
string
Govly web URL for viewing the award
string
URL to the original government source
string
ISO 8601 date when the award was made
string
ISO 8601 date when the award was last modified
string
ISO 8601 timestamp when the record was created in Govly
string
ISO 8601 timestamp when the record was last updated in Govly
string
ISO 8601 date of the related solicitation
string
ISO 8601 date when the period of performance begins
string
ISO 8601 date when the period of performance ends
string
ISO 8601 date of the potential end date including options
number
Total award amount in USD
number
Maximum potential value of the award in USD
number
Amount obligated in USD
number
Amount paid in USD
string
Payment structure type (e.g., “Fixed Price”, “Cost Reimbursement”)
string
Type of acquisition
string
Category of acquisition
string
Extent of competition (e.g., “Full and Open Competition”, “Not Competed”)
string
NAICS code for the award
string
Product Service Code (PSC)
integer
Number of bids received for the award
object
string
Unique key of the parent award (for modifications)
string
External identifier of the parent award
string
External ID of the related solicitation
string
Unique key of the award recipient (UEI)
string
Unique key of the recipient’s parent organization
string
CAGE code of the recipient
object
Information about the award recipient
Show Properties
Show Properties
string
Unique identifier for the recipient (UEI)
string
Recipient organization name
string
CAGE code
object
string | object
AI-enriched headquarters address
string
AI-enriched website URL
object
Information about the buying organization
object
Information about the buying office
object
Information about the funding organization
object
Information about the funding office
string
Place of manufacture designation
object
Error Responses
| Status Code | Condition |
|---|---|
| 401 | Invalid or missing API key |
| 422 | Invalid parameters (see error message for details) |
- “At least one filter is required: start_date, unique_keys, or recipient_ueis”
- “Date range cannot exceed 7 days”
- “unique_keys cannot exceed 100 values”
- “recipient_ueis cannot exceed 100 values”
- “Invalid start_date format”
- “Invalid end_date format”
Example Requests
Filter by date range
curl "https://app.govly.com/api/enterprise/awards?start_date=2024-01-15&end_date=2024-01-20" \
-H "X-API-KEY: your_api_key"
Filter by unique keys
curl "https://app.govly.com/api/enterprise/awards?unique_keys[]=PIID123&unique_keys[]=PIID456" \
-H "X-API-KEY: your_api_key"
Filter by recipient UEIs
curl "https://app.govly.com/api/enterprise/awards?recipient_ueis[]=ABC123DEF456" \
-H "X-API-KEY: your_api_key"
Paginate through results
# First request
curl "https://app.govly.com/api/enterprise/awards?start_date=2024-01-15&page_size=50" \
-H "X-API-KEY: your_api_key"
# Subsequent requests using cursor from previous response
curl "https://app.govly.com/api/enterprise/awards?start_date=2024-01-15&page_size=50&cursor=eyJsYXN0X21vZGlmaWVkX2RhdGUiOiIyMDI0LTAxLTE2IiwiaWQiOjEyMzQ1fQ==" \
-H "X-API-KEY: your_api_key"
Was this page helpful?
⌘I