> ## Documentation Index > Fetch the complete documentation index at: https://docs.govly.com/llms.txt > Use this file to discover all available pages before exploring further. # List awards > Retrieve federal contract awards with filtering by date range, unique key, or recipient ## Request At least one filter is required: `start_date`, `unique_keys[]`, or `recipient_ueis[]`. ### Date Range Filtering 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 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 Array of award unique keys (e.g., FPDS PIID) to retrieve. Maximum 100 values. When provided, `start_date` is not required. Array of recipient UEIs to filter by. Maximum 100 values. When provided, `start_date` is not required. ### Pagination Number of results per page. Maximum: 100. 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 of award objects 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 Set-aside information for the award Set-aside code Set-aside name (e.g., "Small Business Set-Aside") 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 Unique identifier for the recipient (UEI) Recipient organization name CAGE code Recipient address Street address line 1 Street address line 2 Street address line 3 City State or region Postal code Country AI-enriched headquarters address AI-enriched website URL Information about the buying organization 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 Office ID Office 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 organization 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 Office ID Office 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 Place of manufacture designation Location where the work is performed City State or region Postal code Country County Congressional district code Pagination metadata Base64-encoded cursor for the next page of results. Will be `null` if there are no more results. Number of results per page Start date used for filtering (ISO 8601 format) End date used for filtering (ISO 8601 format) ## Error Responses | Status Code | Condition | | ----------- | -------------------------------------------------- | | 401 | Invalid or missing API key | | 422 | Invalid 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 ```bash theme={null} 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 ```bash theme={null} 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 ```bash theme={null} curl "https://app.govly.com/api/enterprise/awards?recipient_ueis[]=ABC123DEF456" \ -H "X-API-KEY: your_api_key" ``` ### Paginate through results ```bash theme={null} # 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" ```