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

​
start_date
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[].
​
end_date
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

​
unique_keys[]
string[]
Array of award unique keys (e.g., FPDS PIID) to retrieve. Maximum 100 values. When provided, start_date is not required.
​
recipient_ueis[]
string[]
Array of recipient UEIs to filter by. Maximum 100 values. When provided, start_date is not required.

​
Pagination

​
page_size
integer
default:100
Number of results per page. Maximum: 100.
​
cursor
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.
​
results
array
Array of award objects
​
meta
object
Pagination metadata

​
Error Responses

Status CodeCondition
401Invalid or missing API key
422Invalid parameters (see error message for details)
Common validation errors:
  • “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"