Get Deal Updates

GET

https://api.runcaptain.com/v2/datasets/odyssey/deals/:id/updates

GET

/v2/datasets/odyssey/deals/:id/updates

1 import requests
2 import json
3 
4 BASE_URL = "https://api.runcaptain.com"
5 API_KEY = "your_api_key"
6 ORG_ID = "your_organization_id"
7 DEAL_ID = "your_entity_id"  # Get this from /deals/search
8 
9 headers = {
10     "Authorization": f"Bearer {API_KEY}",
11     "X-Organization-ID": ORG_ID
12 }
13 
14 # You can also pass a domain (e.g., "openai.com") or name instead of entity_id
15 response = requests.get(
16     f"{BASE_URL}/v2/datasets/odyssey/deals/{{DEAL_ID}}/updates",
17     headers=headers,
18     timeout=30.0
19 )
20 
21 data = response.json()
22 print(f"Update Type: {data.get('update_type')}")
23 print(f"Date: {data.get('date')}")

1 {
2   "deal_id": "deal_openai_0",
3   "updates": [
4     {
5       "timestamp": "2024-06-10T15:22:30Z",
6       "modified_fields": {
7         "status": {
8           "old": "pending",
9           "new": "approved"
10         },
11         "amount": {
12           "old": 50000,
13           "new": 55000
14         }
15       },
16       "updated_by": "jane.doe@example.com",
17       "update_reason": "Client approved increased budget"
18     },
19     {
20       "timestamp": "2024-05-28T09:10:45Z",
21       "modified_fields": {
22         "closing_date": {
23           "old": "2024-06-15",
24           "new": "2024-06-20"
25         }
26       },
27       "updated_by": "john.smith@example.com",
28       "update_reason": "Extended closing date due to contract review"
29     }
30   ],
31   "total_updates": 2
32 }

Get changelog of updates to deal information. Returns history of changes to deal data with timestamps and modified fields.

Authentication

AuthorizationBearer

Bearer token authentication using API key

Path parameters

idstringRequired

Response

Successful response

Get Deal Updates

Authentication

Path parameters

Headers

Response

Errors