> ## 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. # Show an opportunity ## OpenAPI ````yaml /openapi/tools-v1.yaml get /api/tools/v1/opportunities/{id} 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: 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. - 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/opportunities/{id}: get: tags: - Opportunities summary: Show an opportunity operationId: show_opportunity parameters: - $ref: '#/components/parameters/id' responses: '200': description: Opportunity content: application/json: schema: type: object required: - data properties: data: $ref: '#/components/schemas/Opportunity' meta: $ref: '#/components/schemas/ActionMeta' '401': $ref: '#/components/responses/Error' '403': $ref: '#/components/responses/Error' '404': $ref: '#/components/responses/Error' components: parameters: id: name: id in: path required: true schema: type: string schemas: 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' ActionMeta: type: object properties: availableActions: type: array description: >- Structured hints for useful follow-up actions. These are advisory; clients should still rely on tool schemas and authorization. items: $ref: '#/components/schemas/AvailableAction' 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' AvailableAction: type: object required: - name - description - arguments - idPaths properties: name: type: string description: MCP/tool operation name. description: type: string arguments: type: object description: Static arguments to pass to the action. idPaths: type: array description: >- JSON paths where IDs for this action can be found in the current response. items: 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 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 ````