> ## 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 cached opportunity results for a saved search > Returns cached saved-search matches, excluding prediction records. ## OpenAPI ````yaml /openapi/tools-v1.yaml get /api/tools/v1/opportunities/saved_searches/{savedSearchId}/results openapi: 3.1.0 info: title: Govly Tools API version: 1.0.0 description: > REST-callable tool surface for agent and automation workflows. Agents are the primary consumer, but integrations can be built on this API. Within this version, Govly aims to avoid breaking regressions in documented behavior; response objects may receive additional fields at any time. 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: 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: Attachments description: Fetch extracted or readable attachment text. paths: /api/tools/v1/opportunities/saved_searches/{savedSearchId}/results: get: tags: - Saved Searches summary: List cached opportunity results for a saved search description: Returns cached saved-search matches, excluding prediction records. operationId: list_opportunity_saved_search_results parameters: - $ref: '#/components/parameters/savedSearchId' - $ref: '#/components/parameters/cursor' - $ref: '#/components/parameters/perPage' responses: '200': description: Cached saved-search matches content: application/json: schema: type: object required: - data - meta properties: data: type: array items: $ref: '#/components/schemas/OppSearchMatch' meta: $ref: '#/components/schemas/CursorMeta' '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: OppSearchMatch: type: object required: - id - matchedAt - savedSearchId - opportunity properties: id: type: string matchedAt: type: string format: date-time savedSearchId: type: string opportunity: $ref: '#/components/schemas/Opportunity' CursorMeta: type: object required: - count properties: count: type: integer perPage: type: integer nextCursor: type: - string - 'null' Opportunity: type: object required: - id properties: id: type: string description: >- Govly opportunity ID. Use this ID for show requests, workspace associations, and links. title: type: string displayName: type: string description: >- Human-readable opportunity reference, usually source name plus identifier. identifier: type: string description: >- Public opportunity identifier, such as a solicitation or request number. This may differ from raw source-system IDs when Govly merges related notices. externalUrl: type: string format: uri recordType: type: string status: type: string enum: - open - expired - cancelled - awarded - forecasted - unknown postedAt: type: string format: date-time modifiedAt: type: string format: date-time respondBy: type: string format: date-time cancelledAt: type: string format: date-time awardedAt: type: string format: date-time aiTitle: type: string aiSummary: type: string jurisdiction: type: object properties: id: type: string name: type: string isoCode: type: string contractVehicle: type: object properties: id: type: string name: type: string followerCount: type: integer description: >- Count of active follow rows across visible workspaces for this opportunity. followedByCurrentUser: type: boolean description: >- Whether the authenticated user actively follows any visible workspace for this opportunity. followedByCurrentOrganization: type: boolean description: >- Whether the authenticated user's organization actively follows any visible workspace for this opportunity. workspaces: type: array description: >- Visible workspaces associated with this opportunity, including active follow context. items: $ref: '#/components/schemas/OpportunityWorkspace' aggregateAttachments: type: array items: $ref: '#/components/schemas/OpportunityAttachment' opportunitySources: type: array items: $ref: '#/components/schemas/OpportunitySource' 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 OpportunityWorkspace: type: object required: - id - name - status - followerCount - follows properties: id: type: string name: type: string organizationDefault: type: boolean organization: type: object properties: id: type: string name: type: string status: type: object required: - category - label properties: category: type: string label: type: string followerCount: type: integer description: Count of active follow rows on this workspace. followedByCurrentUser: type: boolean followedByCurrentOrganization: type: boolean follows: type: array description: >- Active workspace follows. Inactive/unfollowed/disinterested rows are omitted. items: $ref: '#/components/schemas/WorkspaceMember' OpportunityAttachment: type: object required: - id - filename - redacted properties: id: type: string filename: type: string contentType: type: string byteSize: type: integer redacted: type: boolean tags: type: array items: type: string file: $ref: '#/components/schemas/AttachmentFile' OpportunitySource: type: object required: - id - attachments properties: id: type: string postedAt: type: string format: date-time externalUrl: type: string format: uri noticeType: type: string recordType: type: string attachments: type: array items: $ref: '#/components/schemas/OpportunityAttachment' WorkspaceMember: type: object required: - id - member properties: id: type: string state: type: string notifications: type: string createdAt: type: string format: date-time updatedAt: type: string format: date-time member: type: object required: - type - id properties: type: type: string enum: - user - team id: type: string name: type: string email: type: string format: email organization: type: object properties: id: type: string name: type: string AttachmentFile: type: object description: >- Presigned download metadata. Omitted when the attachment is redacted or URLs are excluded. required: - url - expiresAt properties: url: type: string format: uri expiresAt: type: string format: date-time 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 ````