---
title: "Get opportunity by ID"
method: GET
path: "/opportunities/{id}"
tags: ["Opportunities"]
---

# Get opportunity by ID

`GET /opportunities/{id}`

## Request

- Base URL: `https://api.copper.com/developer_api/v1`
- URL: `https://api.copper.com/developer_api/v1/opportunities/{id}`
- Auth: HTTP bearer

Retrieve a specific opportunity by their ID. This endpoint is eligible to return computed custom field values.

## Path parameters

- `id` integer, required

## Query parameters

- `custom_field_computed_values` boolean

## Response `200`

Opportunity retrieved successfully

- Opportunity
  - `id` integer, required: Unique identifier for the opportunity
  - `name` string, required: The name of the opportunity
  - `assignee_id` integer, nullable: Unique identifier of the user that will be the owner of the opportunity
  - `close_date` integer, nullable: The expected close date of the opportunity (Unix timestamp)
  - `company_id` integer, nullable: The unique identifier of the primary company with which the opportunity is associated
  - `company_name` string, nullable: The name of the primary company with which the opportunity is associated
  - `customer_source_id` integer, nullable: Unique identifier of the customer source that generated this opportunity
  - `details` string, nullable: Description of the opportunity
  - `loss_reason_id` integer, nullable: If the opportunity's status is 'Lost', the unique identifier of the loss reason that caused this opportunity to be lost
  - `monetary_value` number, nullable: The monetary value of the opportunity
  - `pipeline_id` integer: The unique identifier of the pipeline in which this opportunity is
  - `pipeline_is_revenue` boolean: The revenue type of the pipeline associated with the opportunity
  - `pipeline_stage_id` integer: The unique identifier of the pipeline stage of the opportunity
  - `pipeline_type` 'opportunity' | 'project' | 'item': The type of the pipeline ('opportunity', 'project', or 'item') associated with the opportunity
  - `primary_contact_id` integer, nullable: The unique identifier of the person who is the primary contact for this opportunity
  - `priority` 'None' | 'Low' | 'Medium' | 'High': The priority of the opportunity
  - `status` 'Open' | 'Won' | 'Lost' | 'Abandoned': The status of the opportunity
  - `tags` string[]: An array of the tags associated with the opportunity
  - `win_probability` integer: The expected probability of winning the opportunity. Valid values are [0-100] (inclusive)
  - `interaction_count` integer: The number of interactions with this opportunity
  - `date_created` integer: A Unix timestamp representing the time at which this opportunity was created
  - `date_modified` integer: A Unix timestamp representing the time at which this opportunity was last modified
  - `custom_fields` object[]: An array of custom field values belonging to the opportunity. When custom_field_computed_values query parameter is true, each field will include a computed_value with human-readable labels for Dropdown and Multi-select fields.
    - `custom_field_definition_id` integer: The id of the custom field definition for which this custom field stores a value
    - `value` unknown
    - `computed_value` unknown

## Other responses

- `400`: Bad Request - The request was invalid or cannot be served
- `401`: Unauthorized - Authentication credentials were missing or incorrect
- `404`: Not Found - The requested resource was not found
- `429`: Too Many Requests - Rate limit exceeded
- `500`: Internal Server Error - An unexpected error occurred

---

[API](https://skmtc.dev/copper/apis/copper-crm-read-only-api.md) - [All operations](https://skmtc.dev/copper/apis/copper-crm-read-only-api/llms.txt) - [OpenAPI document](https://skmtc.dev/copper/apis/copper-crm-read-only-api/revisions/96adc8557a40?raw)