> ## 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 an award saved search > Runs the saved search live against the award index rather than reading a cached match list, so results reflect the index at call time. The saved search's own relative date window is applied; meta.dateRange reports the absolute window actually searched. ## OpenAPI ````yaml /openapi/tools-v1.yaml get /api/tools/v1/awards/saved_searches/{savedSearchId}/results openapi: 3.1.0 info: title: Govly Tools API (Alpha) version: 1.0.0-alpha description: > ALPHA / UNSTABLE: This API is still in active development. Endpoint behavior, request fields, response fields, error codes, and operation names may change before the Tools API is declared stable. REST-callable tool surface for agent and automation workflows. Agents are the primary consumer, but integrations can be built on this API. Responses are JSON for typed clients; MCP tools may render action results into text-oriented formats separately. servers: - url: https://app.govly.com security: - bearerApiKey: [] - headerApiKey: [] tags: - name: Opportunities description: Search, fetch, and inspect Govly opportunity records. - name: Awards description: Search and inspect awarded government contracts. - name: Contacts description: Search and inspect government points of contact. - name: Signals description: Search clustered procurement and market intelligence signals. - name: Workspaces description: Create, update, and inspect opportunity workspaces. - name: Workspace Members description: Add users and teams to workspaces. - name: Workspace Attachments description: List and upload workspace attachments. - name: Workspace Comments description: Post comments to workspaces. - name: Follows description: Follow opportunities and related workspace activity. - name: Saved Searches description: List saved opportunity searches and cached matches. - name: Documents description: >- Read document representations and request temporary original-file downloads. - name: Quote Submissions description: >- Inspect quote submission requirements, submit quotes, and poll submission status. - name: Inbox description: Read and triage the authenticated user's matched inbox items. paths: /api/tools/v1/awards/saved_searches/{savedSearchId}/results: get: tags: - Saved Searches summary: Execute an award saved search description: > Runs the saved search live against the award index rather than reading a cached match list, so results reflect the index at call time. The saved search's own relative date window is applied; meta.dateRange reports the absolute window actually searched. operationId: execute_award_saved_search parameters: - $ref: '#/components/parameters/savedSearchId' - $ref: '#/components/parameters/cursor' - $ref: '#/components/parameters/perPage' responses: '200': description: Awards currently matching the saved search content: application/json: schema: type: object required: - data - meta properties: data: type: array items: $ref: '#/components/schemas/Award' meta: $ref: '#/components/schemas/AwardSavedSearchExecutionMeta' '400': $ref: '#/components/responses/Error' '401': $ref: '#/components/responses/Error' '403': $ref: '#/components/responses/Error' '404': $ref: '#/components/responses/Error' '422': $ref: '#/components/responses/Error' components: parameters: savedSearchId: name: savedSearchId in: path required: true schema: type: string cursor: name: cursor in: query required: false schema: type: string perPage: name: perPage in: query required: false schema: type: integer default: 25 maximum: 100 schemas: Award: type: object required: - id description: > Stable external award shape. Empty members are omitted rather than rendered blank, and money fields are JSON numbers. Detail responses (show_award) add bounded collections; search responses return the summary shape. properties: id: type: string uniqueKey: type: string description: Stable award business key, such as CONT_AWD_... or CONT_IDV_.... displayName: type: string title: type: string identifier: type: string description: type: string aiSummary: type: string externalUrl: type: string awardUrl: type: string acquisitionType: type: string acquisitionCategory: type: string searchType: type: string enum: - fed - sled - international treasuryAccountIds: type: array items: type: string dates: type: object properties: awardedDate: type: string lastModifiedDate: type: string periodOfPerformanceStartDate: type: string periodOfPerformanceEndDate: type: string periodOfPerformancePotentialEndDate: type: string amounts: type: object properties: awardAmount: type: number obligatedAmount: type: number paidAmount: type: number ceilingAmount: type: number recipient: type: object properties: name: type: string uniqueKey: type: string uei: type: string cageCode: type: string parentUniqueKey: type: string parentName: type: string buyer: $ref: '#/components/schemas/AwardGovernmentEntity' buyingOffice: $ref: '#/components/schemas/AwardGovernmentEntity' funder: $ref: '#/components/schemas/AwardGovernmentEntity' fundingOffice: $ref: '#/components/schemas/AwardGovernmentEntity' classification: type: object properties: psc: type: string naics: type: string setAside: type: object properties: id: type: string name: type: string code: type: string contractVehicle: type: object properties: id: type: string slug: type: string name: type: string parentAward: type: object properties: uniqueKey: type: string identifier: type: string jurisdiction: type: object properties: id: type: string name: type: string isoCode: type: string transactions: type: array description: Detail only. Up to 100, newest action first. items: type: object subAwards: type: array description: Detail only. Up to 100 award summaries. items: type: object subAwardsCount: type: integer description: Detail only. relatedOpportunities: type: array description: Detail only. Up to 25, newest posting first. items: type: object programLinks: type: array description: Detail only. Up to 100. items: type: object awardLineItems: type: array description: Detail only. Up to 100. items: type: object places: type: array description: Detail only. AI-extracted places, most specific category first. items: type: object classificationCodes: type: array description: Detail only. Up to 100 resolved classification codes with codeset. items: type: object contacts: type: array description: Detail only. Up to 100 associated contacts (id, name, email). items: type: object AwardSavedSearchExecutionMeta: type: object required: - total - perPage - searchType - nextCursor description: > Execution metadata for a live award saved-search run. Distinct from CursorMeta, which requires a count this endpoint does not emit. properties: total: type: integer description: Matching awards, capped at 10,000 by the search engine. perPage: type: integer searchType: type: string enum: - fed - sled - international description: The market actually searched. searchTypeDefaulted: type: boolean description: > True when the saved search stored no market and federal was applied as the default. savedSearchId: type: string savedSearchName: type: string dateRange: type: array items: type: string format: date-time description: > The absolute window searched, resolved from the saved search's stored relative day offsets at request time. dateRangeParam: type: string enum: - action_dates - period_of_performance_start_date - period_of_performance_end_date - period_of_performance_potential_end_date - last_modified_date - awarded_date - last_summarized_at description: The award date field the window was applied to. timedOut: type: boolean description: > True when the search engine returned partial results before completing. Treat total and data as a lower bound. nextCursor: type: - string - 'null' AwardGovernmentEntity: type: object properties: id: type: string name: type: string code: type: string ErrorEnvelope: type: object required: - errors properties: errors: type: array items: type: object required: - status - code - title - detail properties: status: type: string code: type: string title: type: string detail: type: string source: type: object properties: pointer: type: string responses: Error: description: Error response content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' securitySchemes: bearerApiKey: type: http scheme: bearer bearerFormat: API key headerApiKey: type: apiKey in: header name: X-API-KEY ````