> ## 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. # Execute a search on a saved search > Search awards using a saved search query ## 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: `relevance` Sort 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_date` ## Response Array of award objects matching the search criteria 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 Object containing highlighted text snippets from fields that matched the saved search criteria 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.) Pagination metadata Current page number Number of items per page Total number of items Total number of pages ## Example Requests ### Basic search execution ```bash theme={null} curl "https://app.govly.com/api/enterprise/awards/saved_searches/abc123/search" \ -H "X-API-KEY: your_api_key" ``` ### With date range override ```bash theme={null} 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 ```bash theme={null} 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" ```