> ## Documentation Index > Fetch the complete documentation index at: https://docs.monaco.com/llms.txt > Use this file to discover all available pages before exploring further. # Get an Opportunity > Gets a single opportunity by its `opportunity_id`. The detail response includes the AI-generated summary, identified risks, and custom fields. ## OpenAPI ````yaml https://api.monaco.com/openapi.json get /v1/opportunities/{opportunity_id} openapi: 3.1.0 info: title: Monaco Public API description: Public API for Monaco version: 1.0.0 servers: - url: https://api.monaco.com security: [] paths: /v1/opportunities/{opportunity_id}: get: tags: - Opportunities summary: Get an Opportunity description: >- Gets a single opportunity by its `opportunity_id`. The detail response includes the AI-generated summary, identified risks, and custom fields. operationId: get_opportunity parameters: - name: opportunity_id in: path required: true schema: type: string format: uuid title: Opportunity Id responses: '200': description: Successful Response content: application/json: schema: $ref: >- #/components/schemas/PublicItemResponse_OpportunityDetailResponse_ example: data: id: opp_abc123 account_id: acc_def456 name: Acme Corp - Enterprise License owner: id: usr_abc123 first_name: Jane last_name: Smith stage: negotiation estimated_value: currency_code: USD amount: 50000 estimated_close_date: '2025-09-30' actual_close_date: '2025-10-15' summary: >- Enterprise deal with strong champion. Procurement review in progress. risks: - Budget constraints - Competing vendor evaluation notes: Follow up after Q3 board meeting tags: - High Priority last_activity_at: '2025-08-20T14:30:00Z' updated_at: '2025-08-21T14:30:00Z' created_at: '2025-06-01T09:00:00Z' custom_field_550e8400-e29b-41d4-a716-446655440001: outbound custom_field_6ba7b810-9dad-11d1-80b4-00c04fd430c8: commit custom_field_f47ac10b-58cc-4372-a567-0e02b2c3d479: Initech custom_field_explanations: custom_field_6ba7b810-9dad-11d1-80b4-00c04fd430c8: title: Reasoning body: Champion is engaged and budget is confirmed. confidence: high citations: - url: https://acme.com/notes/call-42 title: Call notes excerpts: - Budget approved for Q3 meta: timestamp: '2026-04-21T12:00:00Z' 4XX: description: Client error content: application/json: schema: $ref: '#/components/schemas/PublicErrorResponse' components: schemas: PublicItemResponse_OpportunityDetailResponse_: properties: data: $ref: '#/components/schemas/OpportunityDetailResponse' meta: $ref: '#/components/schemas/ResponseMeta' type: object required: - data title: PublicItemResponse[OpportunityDetailResponse] PublicErrorResponse: properties: error: $ref: '#/components/schemas/ErrorDetail' type: object required: - error title: PublicErrorResponse OpportunityDetailResponse: properties: id: type: string title: Id description: Unique identifier for the opportunity examples: - opp_abc123 account_id: type: string title: Account Id description: ID of the associated account examples: - acc_def456 name: anyOf: - type: string - type: 'null' title: Name description: Name of the opportunity examples: - Acme Corp - Enterprise License owner: anyOf: - $ref: '#/components/schemas/OwnerInfo' - type: 'null' description: User who owns the opportunity stage: anyOf: - type: string - type: 'null' title: Stage description: Current pipeline stage of the opportunity examples: - negotiation estimated_value: anyOf: - $ref: '#/components/schemas/EstimatedValue' - type: 'null' description: Estimated monetary value of the opportunity estimated_close_date: anyOf: - type: string - type: 'null' title: Estimated Close Date description: Expected close date for the opportunity examples: - '2025-09-30' actual_close_date: anyOf: - type: string - type: 'null' title: Actual Close Date description: Actual date the opportunity was closed examples: - '2025-10-15' summary: anyOf: - type: string - type: 'null' title: Summary description: AI-generated summary of the opportunity examples: - >- Enterprise deal with strong champion. Procurement review in progress. risks: items: type: string type: array title: Risks description: Identified risks for the opportunity examples: - - Budget constraints - Competing vendor evaluation notes: anyOf: - type: string - type: 'null' title: Notes description: Notes about the opportunity examples: - Follow up after Q3 board meeting tags: items: type: string type: array title: Tags description: List of tag names associated with the opportunity examples: - - High Priority last_activity_at: anyOf: - type: string format: date-time - type: 'null' title: Last Activity At description: Date and time of the last activity on the opportunity examples: - '2025-08-20T14:30:00Z' updated_at: anyOf: - type: string format: date-time - type: 'null' title: Updated At description: Date and time the opportunity record was last updated examples: - '2025-08-21T14:30:00Z' created_at: type: string format: date-time title: Created At description: Date and time the opportunity was created examples: - '2025-06-01T09:00:00Z' custom_field_explanations: anyOf: - additionalProperties: $ref: '#/components/schemas/CustomFieldExplanation' type: object - type: 'null' title: Custom Field Explanations description: >- AI-generated reasoning behind custom field values, keyed by the same `custom_field_` key as the value itself. additionalProperties: true type: object required: - id - account_id - created_at title: OpportunityDetailResponse description: >- Single-resource opportunity response, with AI reasoning behind custom fields. ResponseMeta: properties: timestamp: type: string format: date-time title: Timestamp description: Server timestamp of the response type: object title: ResponseMeta ErrorDetail: properties: code: type: string title: Code description: Machine-readable error code examples: - not_found message: type: string title: Message description: Human-readable error message examples: - Resource not found type: object required: - code - message title: ErrorDetail OwnerInfo: properties: id: type: string title: Id description: Unique identifier of the user examples: - usr_abc123 first_name: anyOf: - type: string - type: 'null' title: First Name description: First name of the user examples: - Jane last_name: anyOf: - type: string - type: 'null' title: Last Name description: Last name of the user examples: - Smith type: object required: - id title: OwnerInfo EstimatedValue: properties: currency_code: anyOf: - type: string - type: 'null' title: Currency Code description: ISO 4217 currency code examples: - USD amount: anyOf: - type: integer - type: 'null' title: Amount description: Unit quantity of the specified currency examples: - 50000 type: object title: EstimatedValue CustomFieldExplanation: properties: title: type: string title: Title description: Explanation heading examples: - Reasoning body: type: string title: Body description: AI-generated explanation for the custom field value confidence: anyOf: - type: string - type: 'null' title: Confidence description: Confidence level of the AI-generated explanation citations: anyOf: - items: $ref: '#/components/schemas/CustomFieldCitation' type: array - type: 'null' title: Citations description: Sources backing the explanation, capped and empty-pruned type: object required: - title - body title: CustomFieldExplanation CustomFieldCitation: properties: url: anyOf: - type: string - type: 'null' title: Url description: Source URL for the citation title: anyOf: - type: string - type: 'null' title: Title description: Title of the cited source excerpts: anyOf: - items: type: string type: array - type: 'null' title: Excerpts description: Relevant excerpts from the cited source type: object title: CustomFieldCitation ````