Batch Lookup Deals | termina

1 import requests 2 3 url = "https://app.termina.ai/api/v1/deal/batch-lookup" 4 5 payload = { "deal_ids": [1, 2, 3] } 6 headers = { 7 "Authorization": "Bearer <token>", 8 "Content-Type": "application/json" 9 } 10 11 response = requests.post(url, json=payload, headers=headers) 12 13 print(response.json())

1 { 2 "total_count": 1, 3 "page": 1, 4 "page_size": 1, 5 "data": [ 6 { 7 "round_name": "string", 8 "id": 1, 9 "group_id": 1, 10 "company": { 11 "name": "string", 12 "domain": "example.com", 13 "id": 1, 14 "group_id": 1, 15 "thumbnail_url": "string", 16 "created_at": "2024-01-15T09:30:00Z", 17 "updated_at": "2024-01-15T09:30:00Z", 18 "is_archived": true 19 }, 20 "files": [ 21 { 22 "name": "string", 23 "id": 1, 24 "deal_id": 1, 25 "type": "deck", 26 "created_at": "2024-01-15T09:30:00Z", 27 "updated_at": "2024-01-15T09:30:00Z", 28 "is_archived": true 29 } 30 ], 31 "notes": "string", 32 "priority": "low", 33 "status": "intake", 34 "round_amount": 1, 35 "round_target": 1, 36 "tags": [ 37 "string" 38 ], 39 "company_summary": "string", 40 "deal_lead_id": 1, 41 "created_at": "2024-01-15T09:30:00Z", 42 "updated_at": "2024-01-15T09:30:00Z", 43 "is_archived": true, 44 "data": { 45 "financials_exist": true, 46 "talent_exists": true, 47 "product_metrics": [ 48 { 49 "user_type": "consumer", 50 "metric": "revenue" 51 } 52 ], 53 "unit_economics_metrics": [ 54 { 55 "user_type": "consumer" 56 } 57 ], 58 "benchmark_user_types": [ 59 "consumer" 60 ], 61 "excel_export_exists": true, 62 "benchmark_categories": [ 63 "saas", 64 "fintech" 65 ] 66 }, 67 "categories": [ 68 "string" 69 ], 70 "deal_lead": { 71 "name": "string", 72 "email": "string", 73 "thumbnail_url": "string" 74 } 75 } 76 ] 77 }

Batch lookup deals by IDs with pagination.

Returns only deals the user has access to (via group membership OR direct deal access). Silently filters out deals without access (no errors for inaccessible deals).

Super users can see all deals.

Authentication

AuthorizationBearer

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

Query Parameters

sort_bystring or nullOptional

sort_orderstringOptionalformat: "^(asc|desc)$"Defaults to asc

pageintegerOptional>=1Defaults to 1

page_sizeintegerOptional>=1Defaults to 100

Request

This endpoint expects an object.

deal_idslist of integersRequired

List of deal IDs to retrieve

Response

Successful Response

total_countinteger

pageinteger

page_sizeinteger

datalist of objects

Authentication

Query Parameters

Request

Response

Errors