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
200
Response for status 200
application/json
get
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-07-15T19:54:57.456Z",
      "updatedAt": "2025-07-15T19:54:57.456Z",
      "organizationId": 1,
      "createdByUserId": 1,
      "integrationInstallationId": 1,
      "vendorEntityId": "text",
      "vendorEntityUrl": "text",
      "companyVendorEntityId": "text",
      "companyDomain": "text",
      "evaluationId": 1,
      "createdDate": "2025-07-15T19:54:57.456Z",
      "updatedDate": "2025-07-15T19:54:57.456Z",
      "deleted": true,
      "deletedDate": "2025-07-15T19:54:57.456Z",
      "name": "text",
      "pipeline": "text",
      "stage": "text",
      "amount": 1,
      "expectedRevenue": 1,
      "probability": 1,
      "description": "text",
      "closed": true,
      "won": true,
      "closeDate": "2025-07-15T19:54:57.456Z",
      "closedLostReason": "text",
      "closedWonReason": "text",
      "nextStep": "text",
      "stageHistory": "text",
      "pilotEndDate": "2025-07-15T19:54:57.456Z",
      "pilotDurationSeconds": 1,
      "latestStageVendorEntityIdBeforeClosedLost": "text",
      "logoUrl": "text",
      "summary": "text",
      "summaryUpdatedAt": "2025-07-15T19:54:57.456Z"
    }
  ],
  "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
200
Response for status 200
application/json
get
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-07-15T19:54:57.456Z",
  "updatedAt": "2025-07-15T19:54:57.456Z",
  "organizationId": 1,
  "createdByUserId": 1,
  "integrationInstallationId": 1,
  "vendorEntityId": "text",
  "vendorEntityUrl": "text",
  "companyVendorEntityId": "text",
  "companyDomain": "text",
  "evaluationId": 1,
  "createdDate": "2025-07-15T19:54:57.456Z",
  "updatedDate": "2025-07-15T19:54:57.456Z",
  "deleted": true,
  "deletedDate": "2025-07-15T19:54:57.456Z",
  "name": "text",
  "pipeline": "text",
  "stage": "text",
  "amount": 1,
  "expectedRevenue": 1,
  "probability": 1,
  "description": "text",
  "closed": true,
  "won": true,
  "closeDate": "2025-07-15T19:54:57.456Z",
  "closedLostReason": "text",
  "closedWonReason": "text",
  "nextStep": "text",
  "stageHistory": "text",
  "pilotEndDate": "2025-07-15T19:54:57.456Z",
  "pilotDurationSeconds": 1,
  "latestStageVendorEntityIdBeforeClosedLost": "text",
  "logoUrl": "text",
  "summary": "text",
  "summaryUpdatedAt": "2025-07-15T19:54:57.456Z"
}

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.

or
stringOptional
Responses
200
Response for status 200
application/json
post
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-07-15T19:54:57.456Z",
  "updatedAt": "2025-07-15T19:54:57.456Z",
  "organizationId": 1,
  "createdByUserId": 1,
  "title": "text",
  "body": "text"
}
PreviousAPI ReferenceNextEvaluations

Last updated