Skip to main content
GET
/
v1
/
integrations
/
opportunities
/
{id}
Get an opportunity
curl --request GET \
  --url https://functions.siro.ai/api-externalApi/v1/integrations/opportunities/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "externalId": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "organizationId": "<string>",
  "name": "<string>",
  "amount": 123,
  "closedAt": "<string>",
  "disposition": "<string>",
  "recordingId": "<string>",
  "accountId": "<string>",
  "account": null,
  "opportunityUsers": [
    null
  ]
}

Authorizations

​
Authorization
string
header
default:<organization-api-token>
required

Organization integration token from Siro admin (Person icon → API Tokens). Send Authorization: Bearer . This is not the OAuth access token used with api.siro.ai user-scoped endpoints.

Path Parameters

​
id
string
required

Response

200 - application/json

Get an opportunity

​
id
string
required
​
externalId
string
required

The ID of the opportunity in the external system (e.g. Salesforce)

​
createdAt
string
required

The date the opportunity was created

​
updatedAt
string
required

The date the opportunity was last updated

​
organizationId
string
required
​
name
string | null

The name of the opportunity

​
amount
number

The dollar amount of the opportunity

​
closedAt
string

The closure date of the opportunity

​
disposition
string

"WON" | "LOST" | "OPEN"

​
recordingId
string

The ID of the recording associated to the opportunity

​
accountId
string
​
account
unknown
​
opportunityUsers
null[]