{"openapi":"3.0.0","info":{"title":"Curvo API","version":"1","description":"Read-only access to your company deals, meetings, actions and transcripts. Send a `curvo_api_` key as a bearer token."},"servers":[{"url":"https://app.curvo.ai/api"}],"security":[{"CustomerApiKey":[]}],"components":{"schemas":{},"parameters":{},"securitySchemes":{"CustomerApiKey":{"type":"http","scheme":"bearer","description":"Company API key with a curvo_api_ prefix"}}},"paths":{"/v1/deals":{"get":{"tags":["Customer API"],"summary":"List deals","description":"Deals with stage, value, owner and their current framework score.","security":[{"CustomerApiKey":[]}],"parameters":[{"schema":{"type":"string","description":"Partial, case-insensitive match on deal or company name.","example":"northwind"},"required":false,"description":"Partial, case-insensitive match on deal or company name.","example":"northwind","name":"search","in":"query"},{"schema":{"type":"string","enum":["IN_PROGRESS","WON","LOST"],"description":"Open, won or lost deals."},"required":false,"description":"Open, won or lost deals.","name":"stageKind","in":"query"},{"schema":{"type":"string","description":"Exact CRM stage name."},"required":false,"description":"Exact CRM stage name.","name":"stage","in":"query"},{"schema":{"type":"integer","description":"Curvo user ID of the owner."},"required":false,"description":"Curvo user ID of the owner.","name":"ownerId","in":"query"},{"schema":{"type":"string","description":"Earliest close date."},"required":false,"description":"Earliest close date.","name":"fromDate","in":"query"},{"schema":{"type":"string","description":"Latest close date."},"required":false,"description":"Latest close date.","name":"toDate","in":"query"},{"schema":{"type":"string","enum":["createdAt","closeDate","monetaryValue","frameworkScore"],"description":"Sort field. Defaults to createdAt. frameworkScore ranks by deal health, with unscored deals last."},"required":false,"description":"Sort field. Defaults to createdAt. frameworkScore ranks by deal health, with unscored deals last.","name":"orderBy","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"description":"Sort direction. Defaults to desc."},"required":false,"description":"Sort direction. Defaults to desc.","name":"direction","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"description":"Results per page, 1 to 200. Defaults to 25."},"required":false,"description":"Results per page, 1 to 200. Defaults to 25.","name":"limit","in":"query"},{"schema":{"type":"integer","minimum":0,"description":"Results to skip. Defaults to 0."},"required":false,"description":"Results to skip. Defaults to 0.","name":"offset","in":"query"}],"responses":{"200":{"description":"JSON data","content":{"application/json":{"schema":{"type":"object","properties":{"deals":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","minimum":0,"exclusiveMinimum":true},"name":{"type":"string"},"frameworkScore":{"type":"object","properties":{}}},"required":["id","name","frameworkScore"]}},"pagination":{"type":"object","properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"hasMore":{"type":"boolean"}},"required":["limit","offset","hasMore"]}},"required":["deals","pagination"]},"example":{"deals":[{"id":1842,"name":"Northwind platform rollout","stageName":"Proposal","ownerName":"Priya Shah","monetaryValue":48000,"monetaryCurrency":"GBP","closeDate":"2026-11-28T00:00:00.000Z","externalCompanyName":"Northwind Traders","createdAt":"2026-08-14T09:12:40.000Z","frameworkScore":{"status":"UP_TO_DATE","projectionMode":"CANONICAL","frameworkName":"MEDDICC","overallScore":68,"lastAnalysedAt":"2026-10-09T16:42:11.000Z","freshness":{"status":"COMPLETE","latestIncludedActivityAt":"2026-10-09T15:30:00.000Z","completedAt":"2026-10-09T16:42:11.000Z"}}}],"pagination":{"limit":25,"offset":0,"hasMore":true}}}}},"400":{"description":"Invalid query parameters"},"401":{"description":"Missing, malformed or revoked customer API key"},"403":{"description":"Company suspended or Public API not enabled"},"404":{"description":"Resource not found"},"405":{"description":"Method not allowed"},"429":{"description":"Per-key rate limit exceeded; wait Retry-After seconds"},"500":{"description":"Internal server error"}}}},"/v1/deals/{dealId}":{"get":{"tags":["Customer API"],"summary":"Get a deal","description":"One deal with stakeholders, recent CRM activity, framework score, risks and AI summary.","security":[{"CustomerApiKey":[]}],"parameters":[{"schema":{"type":"integer","description":"Deal ID from `GET /deals`."},"required":true,"description":"Deal ID from `GET /deals`.","name":"dealId","in":"path"}],"responses":{"200":{"description":"JSON data","content":{"application/json":{"schema":{"type":"object","properties":{"deal":{"type":"object","properties":{"id":{"type":"integer","minimum":0,"exclusiveMinimum":true},"name":{"type":"string"},"frameworkScore":{"type":"object","properties":{}}},"required":["id","name","frameworkScore"]}},"required":["deal"]},"example":{"deal":{"id":1842,"name":"Northwind platform rollout","stageName":"Proposal","ownerName":"Priya Shah","monetaryValue":48000,"monetaryCurrency":"GBP","closeDate":"2026-11-28T00:00:00.000Z","externalCompanyName":"Northwind Traders","createdAt":"2026-08-14T09:12:40.000Z","frameworkScore":{"status":"UP_TO_DATE","projectionMode":"CANONICAL","frameworkName":"MEDDICC","overallScore":68,"lastAnalysedAt":"2026-10-09T16:42:11.000Z","freshness":{"status":"COMPLETE","latestIncludedActivityAt":"2026-10-09T15:30:00.000Z","completedAt":"2026-10-09T16:42:11.000Z"},"framework":{"ref":{"type":"built-in","framework":"MEDDICC"},"name":"MEDDICC"},"sourceCount":13,"components":[{"slug":"economic-buyer","label":"Economic buyer","score":80}]},"pipelineName":"New business","stageKind":"IN_PROGRESS","crmId":"22019384","crmType":"HUBSPOT","region":"EMEA","externalCompanyDomain":"northwind.example","summary":"Commercial review done. Budget approved for 120 seats, pending SSO sign-off.","summaryFormat":"plain","aiState":"UP_TO_DATE","stakeholders":[{"id":771,"name":"Alex Morgan","email":"alex@northwind.example","title":"Head of Revenue Operations","side":"EXTERNAL","role":"Champion","engagementStatus":"ENGAGED","lastEngagedAt":"2026-10-09T14:45:00.000Z","manuallyConfirmed":false}],"activitySummary":{"totalCount":37,"latestActivityAt":"2026-10-09T14:45:00.000Z","counts":[{"objectType":"EMAIL","count":24},{"objectType":"MEETING","count":9},{"objectType":"CALL","count":4}],"recent":[{"id":90211,"objectType":"EMAIL","direction":"INBOUND","crmId":"48213377102","crmType":"HUBSPOT","crmCreatedAt":"2026-10-08T13:05:00.000Z","crmUpdatedAt":"2026-10-08T13:05:00.000Z","title":"Re: Security questionnaire","bodySnippet":"Thanks, our IT team has signed off on SSO. Can we review the order form on Friday?","people":[{"name":"Alex Morgan","email":"alex@northwind.example","relation":"sender"}],"attachments":[]}]},"risks":[{"content":"Launch depends on SSO sign-off","rationale":"Alex tied the budget approval to SSO being ready for launch.","createdAt":"2026-10-09T15:01:22.000Z","meetingTitle":"Northwind | Commercial review"}]}}}}},"400":{"description":"Invalid query parameters"},"401":{"description":"Missing, malformed or revoked customer API key"},"403":{"description":"Company suspended or Public API not enabled"},"404":{"description":"The deal does not exist or belongs to another company."},"405":{"description":"Method not allowed"},"429":{"description":"Per-key rate limit exceeded; wait Retry-After seconds"},"500":{"description":"Internal server error"}}}},"/v1/deals/{dealId}/activities":{"get":{"tags":["Customer API"],"summary":"List deal activities","description":"Emails, calls, meetings, notes, tasks and SMS synced from your CRM, newest first.","security":[{"CustomerApiKey":[]}],"parameters":[{"schema":{"type":"integer","description":"Deal ID from `GET /deals`."},"required":true,"description":"Deal ID from `GET /deals`.","name":"dealId","in":"path"},{"schema":{"type":"array","items":{"type":"string","enum":["CALL","EMAIL","MEETING","TASK","NOTE","SMS","OTHER"]},"description":"Activity types to include."},"required":false,"description":"Activity types to include.","name":"objectTypes","in":"query"},{"schema":{"type":"array","items":{"type":"string","enum":["INBOUND","OUTBOUND","INTERNAL"]},"description":"Activity directions to include."},"required":false,"description":"Activity directions to include.","name":"directions","in":"query"},{"schema":{"type":"string","description":"Earliest activity date."},"required":false,"description":"Earliest activity date.","name":"fromDate","in":"query"},{"schema":{"type":"string","description":"Latest activity date."},"required":false,"description":"Latest activity date.","name":"toDate","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"description":"Results per page, 1 to 100. Defaults to 25."},"required":false,"description":"Results per page, 1 to 100. Defaults to 25.","name":"limit","in":"query"},{"schema":{"type":"integer","minimum":0,"description":"Results to skip. Defaults to 0."},"required":false,"description":"Results to skip. Defaults to 0.","name":"offset","in":"query"}],"responses":{"200":{"description":"JSON data","content":{"application/json":{"schema":{"type":"object","properties":{"activities":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","minimum":0,"exclusiveMinimum":true}},"required":["id"]}},"total":{"type":"integer"},"pagination":{"type":"object","properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"hasMore":{"type":"boolean"}},"required":["limit","offset","hasMore"]}},"required":["activities","total","pagination"]},"example":{"activities":[{"id":90211,"objectType":"EMAIL","direction":"INBOUND","crmId":"48213377102","crmType":"HUBSPOT","crmCreatedAt":"2026-10-08T13:05:00.000Z","crmUpdatedAt":"2026-10-08T13:05:00.000Z","title":"Re: Security questionnaire","bodySnippet":"Thanks, our IT team has signed off on SSO. Can we review the order form on Friday?","people":[{"name":"Alex Morgan","email":"alex@northwind.example","relation":"sender"}],"attachments":[]}],"total":28,"pagination":{"limit":25,"offset":0,"hasMore":true}}}}},"400":{"description":"Invalid query parameters"},"401":{"description":"Missing, malformed or revoked customer API key"},"403":{"description":"Company suspended or Public API not enabled"},"404":{"description":"The deal does not exist or belongs to another company."},"405":{"description":"Method not allowed"},"429":{"description":"Per-key rate limit exceeded; wait Retry-After seconds"},"500":{"description":"Internal server error"}}}},"/v1/deals/{dealId}/framework-score":{"get":{"tags":["Customer API"],"summary":"Get a deal framework score","description":"Your sales framework (MEDDICC, BANT or custom) scored question by question, with rationale and cited evidence.","security":[{"CustomerApiKey":[]}],"parameters":[{"schema":{"type":"integer","description":"Deal ID from `GET /deals`."},"required":true,"description":"Deal ID from `GET /deals`.","name":"dealId","in":"path"}],"responses":{"200":{"description":"JSON data","content":{"application/json":{"schema":{"type":"object","properties":{"frameworkScore":{"type":"object","properties":{"status":{"type":"string"},"components":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"label":{"type":"string"},"score":{"type":"number"}},"required":["slug","label","score"]}}},"required":["status","components"]}},"required":["frameworkScore"]},"example":{"frameworkScore":{"status":"UP_TO_DATE","projectionMode":"CANONICAL","frameworkName":"MEDDICC","overallScore":68,"lastAnalysedAt":"2026-10-09T16:42:11.000Z","freshness":{"status":"COMPLETE","latestIncludedActivityAt":"2026-10-09T15:30:00.000Z","completedAt":"2026-10-09T16:42:11.000Z"},"framework":{"ref":{"type":"built-in","framework":"MEDDICC"},"name":"MEDDICC"},"sourceCount":13,"components":[{"slug":"economic-buyer","label":"Economic buyer","score":80,"questions":[{"id":3301,"text":"Have we identified and engaged the economic buyer?","weight":1,"level":"SATISFIED","score":80,"rationale":"Alex confirmed that the CFO approved the budget for 120 seats.","citations":[{"chunkId":99812,"polarity":"SUPPORTING","quote":"Budget is approved for 120 seats.","sourceType":"MEETING","sourceTitle":"Northwind | Commercial review","occurredAt":"2026-10-09T14:12:04.000Z","meetingId":5521,"speaker":"Alex Morgan","author":null}]}]}]}}}}},"400":{"description":"Invalid query parameters"},"401":{"description":"Missing, malformed or revoked customer API key"},"403":{"description":"Company suspended or Public API not enabled"},"404":{"description":"The deal does not exist, belongs to another company, or has not been scored."},"405":{"description":"Method not allowed"},"429":{"description":"Per-key rate limit exceeded; wait Retry-After seconds"},"500":{"description":"Internal server error"}}}},"/v1/meetings":{"get":{"tags":["Customer API"],"summary":"List meetings","description":"Recorded and scheduled meetings with their linked deal and a short summary.","security":[{"CustomerApiKey":[]}],"parameters":[{"schema":{"type":"string","description":"Partial, case-insensitive match on meeting title."},"required":false,"description":"Partial, case-insensitive match on meeting title.","name":"search","in":"query"},{"schema":{"type":"integer","description":"Meetings linked to a deal."},"required":false,"description":"Meetings linked to a deal.","name":"dealId","in":"query"},{"schema":{"type":"string","format":"email","description":"Meetings this person attended."},"required":false,"description":"Meetings this person attended.","name":"participantEmail","in":"query"},{"schema":{"type":"string","enum":["SCHEDULED","IN_PROGRESS","PROCESSING","COMPLETED","FAILED","CANCELLED"],"description":"Meeting status, case-insensitive."},"required":false,"description":"Meeting status, case-insensitive.","name":"status","in":"query"},{"schema":{"type":"integer","description":"Curvo user ID of the owner."},"required":false,"description":"Curvo user ID of the owner.","name":"ownerId","in":"query"},{"schema":{"type":"string","description":"Earliest meeting time."},"required":false,"description":"Earliest meeting time.","name":"fromDate","in":"query"},{"schema":{"type":"string","description":"Latest meeting time."},"required":false,"description":"Latest meeting time.","name":"toDate","in":"query"},{"schema":{"type":"string","enum":["meetingTime","createdAt"],"description":"Sort field. Defaults to meetingTime."},"required":false,"description":"Sort field. Defaults to meetingTime.","name":"orderBy","in":"query"},{"schema":{"type":"string","enum":["asc","desc"],"description":"Sort direction. Defaults to desc."},"required":false,"description":"Sort direction. Defaults to desc.","name":"direction","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"description":"Results per page, 1 to 200. Defaults to 25."},"required":false,"description":"Results per page, 1 to 200. Defaults to 25.","name":"limit","in":"query"},{"schema":{"type":"integer","minimum":0,"description":"Results to skip. Defaults to 0."},"required":false,"description":"Results to skip. Defaults to 0.","name":"offset","in":"query"}],"responses":{"200":{"description":"JSON data","content":{"application/json":{"schema":{"type":"object","properties":{"meetings":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","minimum":0,"exclusiveMinimum":true},"title":{"type":"string","nullable":true},"dealId":{"type":"integer","nullable":true,"minimum":0,"exclusiveMinimum":true}},"required":["id","title","dealId"]}},"pagination":{"type":"object","properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"hasMore":{"type":"boolean"}},"required":["limit","offset","hasMore"]}},"required":["meetings","pagination"]},"example":{"meetings":[{"id":5521,"title":"Northwind | Commercial review","meetingTime":"2026-10-09T14:00:00.000Z","meetingEndTime":"2026-10-09T14:45:00.000Z","duration":"00:45:00","status":"COMPLETED","dealId":1842,"dealName":"Northwind platform rollout","crmAssociations":[{"crmType":"HUBSPOT","companyId":"1093847","companyName":"Northwind Traders","dealId":"22019384","dealName":"Northwind platform rollout"}],"summarySnippet":"Alex confirmed budget for 120 seats and asked for a revised order form by Friday."}],"pagination":{"limit":25,"offset":0,"hasMore":true}}}}},"400":{"description":"Invalid query parameters"},"401":{"description":"Missing, malformed or revoked customer API key"},"403":{"description":"Company suspended or Public API not enabled"},"404":{"description":"Resource not found"},"405":{"description":"Method not allowed"},"429":{"description":"Per-key rate limit exceeded; wait Retry-After seconds"},"500":{"description":"Internal server error"}}}},"/v1/meetings/{meetingId}":{"get":{"tags":["Customer API"],"summary":"Get a meeting","description":"Full summary, participants with talk time, owners, follow-up actions and highlights.","security":[{"CustomerApiKey":[]}],"parameters":[{"schema":{"type":"integer","description":"Meeting ID from `GET /meetings`."},"required":true,"description":"Meeting ID from `GET /meetings`.","name":"meetingId","in":"path"}],"responses":{"200":{"description":"JSON data","content":{"application/json":{"schema":{"type":"object","properties":{"meeting":{"type":"object","properties":{"id":{"type":"integer","minimum":0,"exclusiveMinimum":true},"title":{"type":"string","nullable":true},"dealId":{"type":"integer","nullable":true,"minimum":0,"exclusiveMinimum":true}},"required":["id","title","dealId"]}},"required":["meeting"]},"example":{"meeting":{"id":5521,"title":"Northwind | Commercial review","meetingTime":"2026-10-09T14:00:00.000Z","meetingEndTime":"2026-10-09T14:45:00.000Z","duration":"00:45:00","status":"COMPLETED","dealId":1842,"dealName":"Northwind platform rollout","crmAssociations":[{"crmType":"HUBSPOT","companyId":"1093847","companyName":"Northwind Traders","dealId":"22019384","dealName":"Northwind platform rollout"}],"summarySnippet":"Alex confirmed budget for 120 seats and asked for a revised order form by Friday.","summary":"## Outcome\nBudget approved for 120 seats, conditional on SSO.\n\n## Next steps\nPriya sends the revised order form by Friday.","participants":[{"name":"Alex Morgan","email":"alex@northwind.example","isInternal":false,"percentageTalkTime":46},{"name":"Priya Shah","email":"priya@yourcompany.example","isInternal":true,"percentageTalkTime":54}],"owners":[{"firstName":"Priya","lastName":"Shah","email":"priya@yourcompany.example","isOrganiser":true}],"actions":[{"name":"Send revised order form with 120 seats","completed":false,"priority":"High","createdAt":"2026-10-09T15:01:22.000Z"}],"highlights":[{"text":"Budget is approved for 120 seats, as long as SSO is in place for launch.","speaker":"Alex Morgan","start":"00:12:04","end":"00:12:11","score":"90"}]}}}}},"400":{"description":"Invalid query parameters"},"401":{"description":"Missing, malformed or revoked customer API key"},"403":{"description":"Company suspended or Public API not enabled"},"404":{"description":"The meeting does not exist or belongs to another company."},"405":{"description":"Method not allowed"},"429":{"description":"Per-key rate limit exceeded; wait Retry-After seconds"},"500":{"description":"Internal server error"}}}},"/v1/meetings/{meetingId}/transcript":{"get":{"tags":["Customer API"],"summary":"Get a transcript","description":"The full transcript as ordered, speaker-attributed segments.","security":[{"CustomerApiKey":[]}],"parameters":[{"schema":{"type":"integer","description":"Meeting ID from `GET /meetings`."},"required":true,"description":"Meeting ID from `GET /meetings`.","name":"meetingId","in":"path"}],"responses":{"200":{"description":"JSON data","content":{"application/json":{"schema":{"type":"object","properties":{"segments":{"type":"array","items":{"type":"object","properties":{"speaker":{"type":"string","nullable":true},"participantName":{"type":"string","nullable":true},"text":{"type":"string"},"start":{"type":"string","nullable":true},"end":{"type":"string","nullable":true}},"required":["speaker","participantName","text","start","end"]}}},"required":["segments"]},"example":{"segments":[{"speaker":"A","participantName":"Alex Morgan","text":"Budget is approved for 120 seats, as long as SSO is in place for launch.","start":"00:12:04","end":"00:12:11"},{"speaker":"B","participantName":"Priya Shah","text":"SSO is included. I will send the revised order form by Friday.","start":"00:12:12","end":"00:12:17"}]}}}},"400":{"description":"Invalid query parameters"},"401":{"description":"Missing, malformed or revoked customer API key"},"403":{"description":"Company suspended or Public API not enabled"},"404":{"description":"The meeting does not exist, belongs to another company, or has no transcript yet."},"405":{"description":"Method not allowed"},"429":{"description":"Per-key rate limit exceeded; wait Retry-After seconds"},"500":{"description":"Internal server error"}}}},"/v1/actions":{"get":{"tags":["Customer API"],"summary":"List actions","description":"Follow-up actions Curvo extracted from meetings.","security":[{"CustomerApiKey":[]}],"parameters":[{"schema":{"type":"boolean","description":"Defaults to false, which returns outstanding actions."},"required":false,"description":"Defaults to false, which returns outstanding actions.","name":"completed","in":"query"},{"schema":{"type":"integer","description":"Actions for a deal."},"required":false,"description":"Actions for a deal.","name":"dealId","in":"query"},{"schema":{"type":"integer","description":"Actions from a meeting."},"required":false,"description":"Actions from a meeting.","name":"meetingId","in":"query"},{"schema":{"type":"integer","description":"Curvo user ID of the owner."},"required":false,"description":"Curvo user ID of the owner.","name":"ownerId","in":"query"},{"schema":{"type":"string","description":"Earliest creation date."},"required":false,"description":"Earliest creation date.","name":"fromDate","in":"query"},{"schema":{"type":"string","description":"Latest creation date."},"required":false,"description":"Latest creation date.","name":"toDate","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":200,"description":"Results per page, 1 to 200. Defaults to 25."},"required":false,"description":"Results per page, 1 to 200. Defaults to 25.","name":"limit","in":"query"},{"schema":{"type":"integer","minimum":0,"description":"Results to skip. Defaults to 0."},"required":false,"description":"Results to skip. Defaults to 0.","name":"offset","in":"query"}],"responses":{"200":{"description":"JSON data","content":{"application/json":{"schema":{"type":"object","properties":{"actions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","minimum":0,"exclusiveMinimum":true},"meetingId":{"type":"integer","minimum":0,"exclusiveMinimum":true},"name":{"type":"string"},"completed":{"type":"boolean"}},"required":["id","meetingId","name","completed"]}},"pagination":{"type":"object","properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"hasMore":{"type":"boolean"}},"required":["limit","offset","hasMore"]}},"required":["actions","pagination"]},"example":{"actions":[{"id":30419,"meetingId":5521,"meetingTitle":"Northwind | Commercial review","meetingTime":"2026-10-09T14:00:00.000Z","dealId":1842,"dealName":"Northwind platform rollout","name":"Send revised order form with 120 seats","completed":false,"priority":"High","createdAt":"2026-10-09T15:01:22.000Z","actionTime":"2026-10-10T17:00:00.000Z"}],"pagination":{"limit":25,"offset":0,"hasMore":false}}}}},"400":{"description":"Invalid query parameters"},"401":{"description":"Missing, malformed or revoked customer API key"},"403":{"description":"Company suspended or Public API not enabled"},"404":{"description":"Resource not found"},"405":{"description":"Method not allowed"},"429":{"description":"Per-key rate limit exceeded; wait Retry-After seconds"},"500":{"description":"Internal server error"}}}},"/v1/transcripts/search":{"get":{"tags":["Customer API"],"summary":"Search transcripts","description":"Semantic search across every transcript and summary. Returns up to 8 ranked excerpts. `partial: true` means the search hit its time limit before checking everything.","security":[{"CustomerApiKey":[]}],"parameters":[{"schema":{"type":"string","description":"What to look for, in plain language.","example":"concerns about SSO"},"required":true,"description":"What to look for, in plain language.","example":"concerns about SSO","name":"query","in":"query"},{"schema":{"type":"array","items":{"type":"integer"},"maxItems":200,"description":"Only search these meetings, up to 200."},"required":false,"description":"Only search these meetings, up to 200.","name":"meetingIds","in":"query"},{"schema":{"type":"string","format":"date-time","description":"Earliest meeting time, with a timezone, for example 2026-09-01T00:00:00Z."},"required":false,"description":"Earliest meeting time, with a timezone, for example 2026-09-01T00:00:00Z.","name":"fromDate","in":"query"},{"schema":{"type":"string","format":"date-time","description":"Latest meeting time, with a timezone."},"required":false,"description":"Latest meeting time, with a timezone.","name":"toDate","in":"query"}],"responses":{"200":{"description":"JSON data","content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"marker":{"type":"string"},"meetingId":{"type":"integer","minimum":0,"exclusiveMinimum":true},"text":{"type":"string"}},"required":["marker","meetingId","text"]}},"partial":{"type":"boolean","enum":[true]}},"required":["results"]},"example":{"results":[{"marker":"[1]","meetingId":5521,"meetingTitle":"Northwind | Commercial review","meetingDate":"2026-10-09T14:00:00.000Z","chunkType":"transcript","externalCompanyName":"Northwind Traders","dealName":"Northwind platform rollout","speakersInChunk":["Alex Morgan","Priya Shah"],"text":"Alex Morgan: Budget is approved for 120 seats, as long as SSO is in place for launch."}]}}}},"400":{"description":"Invalid query parameters"},"401":{"description":"Missing, malformed or revoked customer API key"},"403":{"description":"Company suspended or Public API not enabled"},"404":{"description":"Resource not found"},"405":{"description":"Method not allowed"},"429":{"description":"Per-key rate limit exceeded; wait Retry-After seconds"},"500":{"description":"Internal server error"},"503":{"description":"Transcript search unavailable"}}}},"/v1/openapi.json":{"get":{"tags":["Customer API"],"summary":"Customer API OpenAPI document","description":"OpenAPI 3 document for the customer API only. No key required.","security":[],"responses":{"200":{"description":"OpenAPI document","content":{"application/json":{"schema":{"type":"object","properties":{}}}}}}}}}}