Retrieve an opportunity

GET

https://api.close.com/api/v1/opportunity/:id/

GET

/api/v1/opportunity/:id/

$ curl https://api.close.com/api/v1/opportunity/id/ \
>      -u "<CLOSE_API_KEY>:"

1 {
2   "annualized_expected_value": 37500,
3   "annualized_value": 50000,
4   "confidence": 75,
5   "contact_id": null,
6   "created_by": "user_N6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA",
7   "date_created": "2013-02-01T00:54:51.337000+00:00",
8   "date_lost": null,
9   "date_updated": "2013-02-01T00:54:51.337000+00:00",
10   "date_won": null,
11   "expected_value": 37500,
12   "id": "oppo_8eB77gAdf8FMy6GsNHEy84f7uoeEWv55slvUjKQZpJt",
13   "lead_id": "lead_IIDHIStmFcFQZZP0BRe99V1MCoXWz2PGCm6EDmR9v2O",
14   "note": "Bruce needs new software for the Bat Cave.",
15   "note_html": "<body><p>Bruce needs new software for the Bat Cave.</p></body>",
16   "organization_id": "orga_RbREgmiiwcr1w2b4cOnCMQaQPSIFxMqAD2Dh243uxcH",
17   "status_id": "stat_4ZdiZqcSIkoGVnNOyxiEY58eTGQmFNG3LPlEVQ4V7Nk",
18   "updated_by": "user_N6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA",
19   "user_id": "user_N6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA",
20   "value": 50000,
21   "value_period": "one_time",
22   "lead_name": "Wayne Enterprises (Sample Lead)",
23   "pipeline_id": "pipe_04fC628PVB0HjK2Qq5EqEf",
24   "pipeline_name": "Sales",
25   "status_label": "Active",
26   "status_type": "active",
27   "user_name": "John Doe",
28   "value_currency": "USD",
29   "value_formatted": "$500",
30   "custom.cf_j0P7kHmgFTZZnYBFtyPSZ3uQw4dpW8xKcW7Krps8atj": "https://www.example.com/contract.pdf"
31 }

Authentication

AuthorizationBasic

Use your API key as the username and leave the password empty.

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

idstringRequired

Query parameters

_fieldsstringOptional

Comma-separated list of fields to include in the response.

Response

Successful response

annualized_expected_valueinteger or null

annualized_valueinteger or null

confidenceinteger

contact_idstring or null

created_bystring or null

date_createddatetime

date_lostdatetime or null

date_updateddatetime

date_wondate or null

expected_valueinteger or null

idstring

lead_idstring

notestring or null

note_htmlstring or null

organization_idstring

status_idstring

updated_bystring or null

user_idstring

valueinteger or null

value_periodenum

attachmentslist of objectsOptional

comment_summaryobject or nullOptional

contact_namestring or nullOptional

created_by_namestring or nullOptional

integration_linkslist of objectsOptional

is_stalledbooleanOptional

lead_namestring or nullOptional

lead_primary_emailobject or nullOptional

lead_primary_phonelist of objects or nullOptional

pipeline_idstring or nullOptional

pipeline_namestring or nullOptional

stall_statusobject or nullOptional

status_display_namestringOptional

status_labelstringOptional

status_typeenumOptional

suggested_actionobject or nullOptional

updated_by_namestring or nullOptional

user_namestring or nullOptional

value_currencystring or nullOptional

value_formattedstring or nullOptional

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error