Deals

Manage deals

List Deals

get

List deals. Requires the 'deals:read' scope.

Authorizations

Query parameters

limitnumber · min: 1 · max: 1000optional

The number of results to return

Default: 100

offsetnumberoptional

The number of results to skip

Default: 0

includeSummarybooleanoptional

Include the AI-generated summary of the deal

Default: false

includeDeletedbooleanoptional

Include deleted deals

Default: false

Responses

application/json

objectoptional

application/json

get

HTTPcURLJavaScriptPython

GET /v1/deals HTTP/1.1
Host: api.tryopine.com
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "items": [
    {
      "pilotResult": "TECH_WIN",
      "id": 1,
      "createdAt": "2025-04-16T16:53:53.750Z",
      "updatedAt": "2025-04-16T16:53:53.750Z",
      "organizationId": 1,
      "createdByUserId": 1,
      "integrationInstallationId": 1,
      "vendorEntityId": "text",
      "vendorEntityUrl": "text",
      "companyVendorEntityId": "text",
      "companyDomain": "text",
      "evaluationId": 1,
      "createdDate": "2025-04-16T16:53:53.750Z",
      "updatedDate": "2025-04-16T16:53:53.750Z",
      "deleted": true,
      "deletedDate": "2025-04-16T16:53:53.750Z",
      "name": "text",
      "pipeline": "text",
      "stage": "text",
      "amount": 1,
      "expectedRevenue": 1,
      "probability": 1,
      "description": "text",
      "closed": true,
      "won": true,
      "closeDate": "2025-04-16T16:53:53.750Z",
      "closedLostReason": "text",
      "closedWonReason": "text",
      "nextStep": "text",
      "stageHistory": "text",
      "pilotEndDate": "2025-04-16T16:53:53.750Z",
      "pilotDurationSeconds": 1,
      "latestStageVendorEntityIdBeforeClosedLost": "text",
      "logoUrl": "text",
      "summary": "text",
      "summaryUpdatedAt": "2025-04-16T16:53:53.750Z"
    }
  ],
  "limit": 1,
  "offset": 1,
  "totalCount": 1
}

Get Deal

get

Get a deal by ID or vendor entity ID. Requires the 'deals:read' scope.

Authorizations

Path parameters

idstringrequired

The Opine ID or external service ID of the deal. When supplying an external service ID, the value must begin with 'eid:' (e.g. eid:1234567890)

Query parameters

limitnumber · min: 1 · max: 1000optional

The number of results to return

Default: 100

offsetnumberoptional

The number of results to skip

Default: 0

includeSummarybooleanoptional

Include the AI-generated summary of the deal

Default: false

Responses

application/json

objectoptional

application/json

get

HTTPcURLJavaScriptPython

GET /v1/deals/{id} HTTP/1.1
Host: api.tryopine.com
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "pilotResult": "TECH_WIN",
  "id": 1,
  "createdAt": "2025-04-16T16:53:53.750Z",
  "updatedAt": "2025-04-16T16:53:53.750Z",
  "organizationId": 1,
  "createdByUserId": 1,
  "integrationInstallationId": 1,
  "vendorEntityId": "text",
  "vendorEntityUrl": "text",
  "companyVendorEntityId": "text",
  "companyDomain": "text",
  "evaluationId": 1,
  "createdDate": "2025-04-16T16:53:53.750Z",
  "updatedDate": "2025-04-16T16:53:53.750Z",
  "deleted": true,
  "deletedDate": "2025-04-16T16:53:53.750Z",
  "name": "text",
  "pipeline": "text",
  "stage": "text",
  "amount": 1,
  "expectedRevenue": 1,
  "probability": 1,
  "description": "text",
  "closed": true,
  "won": true,
  "closeDate": "2025-04-16T16:53:53.750Z",
  "closedLostReason": "text",
  "closedWonReason": "text",
  "nextStep": "text",
  "stageHistory": "text",
  "pilotEndDate": "2025-04-16T16:53:53.750Z",
  "pilotDurationSeconds": 1,
  "latestStageVendorEntityIdBeforeClosedLost": "text",
  "logoUrl": "text",
  "summary": "text",
  "summaryUpdatedAt": "2025-04-16T16:53:53.750Z"
}

Create Note

post

Create a note for a deal. Requires the 'deals:write' scope.

Authorizations

Path parameters

idstringrequired

The Opine ID or external service ID of the deal. When supplying an external service ID, the value must begin with 'eid:' (e.g. eid:1234567890)

Body

titlestring · min: 1 · max: 512required

The title of the note.

bodyany ofoptional

The body of the note. An array of Slate nodes or a markdown string.

Responses

application/json

objectoptional

application/json

post

HTTPcURLJavaScriptPython

POST /v1/deals/{id}/notes HTTP/1.1
Host: api.tryopine.com
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 130

{
  "title": "text",
  "body": [
    {
      "type": "text",
      "children": [
        {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        }
      ],
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ]
}

{
  "id": 1,
  "createdAt": "2025-04-16T16:53:53.750Z",
  "updatedAt": "2025-04-16T16:53:53.750Z",
  "organizationId": 1,
  "createdByUserId": 1,
  "title": "text",
  "body": "text"
}