Getting Started
Execute a search on a saved search
Copy
Ask AI
curl --request GET \
--url https://app.govly.com/api/enterprise/awards/saved_searches/{id}/search \
--header 'X-API-KEY: <api-key>'Copy
Ask AI
{
"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>"
},
"highlights": {
"[field_name]": [
"<string>"
]
}
}
],
"meta": {
"currentPage": 123,
"per": 123,
"total": 123,
"totalPages": 123
}
}Saved Searches
Execute a search on a saved search
Search awards using a saved search query
GET
https://app.govly.com
/
api
/
enterprise
/
awards
/
saved_searches
/
{id}
/
search
Execute a search on a saved search
Copy
Ask AI
curl --request GET \
--url https://app.govly.com/api/enterprise/awards/saved_searches/{id}/search \
--header 'X-API-KEY: <api-key>'Copy
Ask AI
{
"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>"
},
"highlights": {
"[field_name]": [
"<string>"
]
}
}
],
"meta": {
"currentPage": 123,
"per": 123,
"total": 123,
"totalPages": 123
}
}Request
ID of the saved search to execute
Number of results per page (max: 100)
Page number for pagination
Which field to use for sorting. Must be one of:
relevance, period_of_performance_start_date, last_modified_date, or awarded_date. Default: relevanceSort direction for results (
asc or desc)Start date for filtering results (ISO 8601 format). Default: uses saved search relative date range or 1 day ago
End date for filtering results (ISO 8601 format). Default: uses saved search relative date range or current date
Which date field to use for date range filtering. Must be one of:
period_of_performance_start_date, last_modified_date, or awarded_date. Default: period_of_performance_start_dateResponse
Array of award objects matching the search criteria
Show Award Properties
Show Award Properties
Unique identifier for the award
Unique identifier key for the award (e.g., FPDS PIID)
External identifier for the award
Title of the award
Description of the award
AI-generated summary of the award
Award category (e.g., “contract”, “grant”)
Govly web URL for viewing the award
URL to the original government source
ISO 8601 date when the award was made
ISO 8601 date when the award was last modified
ISO 8601 timestamp when the record was created in Govly
ISO 8601 timestamp when the record was last updated in Govly
ISO 8601 date of the related solicitation
ISO 8601 date when the period of performance begins
ISO 8601 date when the period of performance ends
ISO 8601 date of the potential end date including options
Total award amount in USD
Maximum potential value of the award in USD
Amount obligated in USD
Amount paid in USD
Payment structure type (e.g., “Fixed Price”, “Cost Reimbursement”)
Type of acquisition
Category of acquisition
Extent of competition (e.g., “Full and Open Competition”, “Not Competed”)
NAICS code for the award
Product Service Code (PSC)
Number of bids received for the award
Unique key of the parent award (for modifications)
External identifier of the parent award
External ID of the related solicitation
Unique key of the award recipient (UEI)
Unique key of the recipient’s parent organization
CAGE code of the recipient
Information about the award recipient
Show Properties
Show Properties
Unique identifier for the recipient (UEI)
Recipient organization name
CAGE code
AI-enriched headquarters address
AI-enriched website URL
Information about the buying organization
Show Properties
Show Properties
Organization ID
Organization name
Array of organization names from highest to lowest level
Array of organization IDs corresponding to the hierarchy
AI-enriched organization website
AI-enriched headquarters address
Information about the buying office
Show Properties
Show Properties
Information about the funding organization
Show Properties
Show Properties
Organization ID
Organization name
Array of organization names from highest to lowest level
Array of organization IDs corresponding to the hierarchy
AI-enriched organization website
AI-enriched headquarters address
Information about the funding office
Show Properties
Show Properties
Place of manufacture designation
Object containing highlighted text snippets from fields that matched the saved search criteria
Show Properties
Show Properties
Array of text snippets from the field containing highlighted matches. The field name will be the name of the field that contained matches (e.g.,
title, description, etc.)Example Requests
Basic search execution
Copy
Ask AI
curl "https://app.govly.com/api/enterprise/awards/saved_searches/abc123/search" \
-H "X-API-KEY: your_api_key"
With date range override
Copy
Ask AI
curl "https://app.govly.com/api/enterprise/awards/saved_searches/abc123/search?start_date=2024-01-01&end_date=2024-01-31" \
-H "X-API-KEY: your_api_key"
With sorting and pagination
Copy
Ask AI
curl "https://app.govly.com/api/enterprise/awards/saved_searches/abc123/search?sort=awarded_date&sort_direction=desc&per=25&page=2" \
-H "X-API-KEY: your_api_key"
⌘I