Route Directory
This page is a simple endpoint directory. Expand any route to view the JSON response shape returned by the API.
Response shapes on this page as of May 6th, 2026.
V2 Routes
Organizations
GET /api/v2/organizations
{
"data": [
{
"organization_id": "gAAAAABexampleOrganizationIdReturnedByApi7mN4qP2xLs9dV5kTr8cY1hJ6uW3",
"name": "Acme Roofing"
}
]
}
Contacts
GET /api/v2/organizations/{organization_id}/contacts
{
"data": [
{
"contact_id": "gAAAAABexampleContactIdReturnedByApi4pQ8xLm2sV7kRt1cN5hY9uJ3dF6",
"name": "Diana Prince",
"email": "[email protected]",
"phone_number": "513-867-5309",
"created_at": "2026-03-12T00:32:13.782565Z",
"company_id": "gAAAAABexampleCompanyIdReturnedByApi6vT2mQ9xLs4dK7pNc1hY5uJ8rF3",
"notes": "Prefers SMS",
"company_role": "Facilities Manager"
}
],
"pagination": {
"limit": 25,
"cursor": null,
"next_cursor": null,
"has_more": false
}
}
GET /api/v2/organizations/{organization_id}/contacts/{contact_id}
{
"contact_id": "gAAAAABexampleContactIdReturnedByApi4pQ8xLm2sV7kRt1cN5hY9uJ3dF6",
"name": "Diana Prince",
"email": "[email protected]",
"phone_number": "513-867-5309",
"created_at": "2026-03-12T00:32:13.782565Z",
"company_id": "gAAAAABexampleCompanyIdReturnedByApi6vT2mQ9xLs4dK7pNc1hY5uJ8rF3",
"notes": "Prefers SMS",
"company_role": "Facilities Manager"
}
GET /api/v2/organizations/{organization_id}/contacts/{contact_id}/conversations
{
"data": [
{
"conversation_id": "gAAAAABexampleConversationIdReturnedByApi8kP3xLs7dV2mTr5cN9hY1uJ4",
"start_at": "2026-03-12T00:32:13.790998Z",
"last_activity_at": "2026-03-12T00:32:13.797290Z",
"folder": "primary",
"is_read": true,
"contact_id": "gAAAAABexampleContactIdReturnedByApi4pQ8xLm2sV7kRt1cN5hY9uJ3dF6"
}
],
"pagination": {
"limit": 50,
"cursor": null,
"next_cursor": null,
"has_more": false
}
}
Companies
GET /api/v2/organizations/{organization_id}/companies
{
"data": [
{
"company_id": "gAAAAABexampleCompanyIdReturnedByApi6vT2mQ9xLs4dK7pNc1hY5uJ8rF3",
"name": "HyperRep Consumer Group",
"domain": "hyperrep.com",
"notes": "Priority account",
"address": "123 Main St, Anytown USA",
"agent_id": "gAAAAABexampleAgentIdReturnedByApi5qN8xLm3sV6kRt2cY9hJ4uW1dF7",
"created_at": "2026-03-10T12:00:00Z"
}
],
"pagination": {
"limit": 25,
"cursor": null,
"next_cursor": null,
"has_more": false
}
}
GET /api/v2/organizations/{organization_id}/companies/{company_id}
{
"company_id": "gAAAAABexampleCompanyIdReturnedByApi6vT2mQ9xLs4dK7pNc1hY5uJ8rF3",
"name": "HyperRep Consumer Group",
"domain": "hyperrep.com",
"notes": "Priority account",
"address": "123 Main St, Anytown USA",
"agent_id": "gAAAAABexampleAgentIdReturnedByApi5qN8xLm3sV6kRt2cY9hJ4uW1dF7",
"created_at": "2026-03-10T12:00:00Z"
}
Agents
GET /api/v2/organizations/{organization_id}/agents
{
"data": [
{
"agent_id": "gAAAAABexampleAgentIdReturnedByApi5qN8xLm3sV6kRt2cY9hJ4uW1dF7",
"name": "Kara Danvers",
"email": "[email protected]"
}
],
"pagination": {
"limit": 25,
"cursor": null,
"next_cursor": null,
"has_more": false
}
}
GET /api/v2/organizations/{organization_id}/agents/{agent_id}
{
"agent_id": "gAAAAABexampleAgentIdReturnedByApi5qN8xLm3sV6kRt2cY9hJ4uW1dF7",
"name": "Kara Danvers",
"email": "[email protected]"
}
GET /api/v2/organizations/{organization_id}/agents/{agent_id}/conversations
{
"data": [
{
"conversation_id": "gAAAAABexampleConversationIdReturnedByApi8kP3xLs7dV2mTr5cN9hY1uJ4",
"start_at": "2026-03-12T01:28:11.008525Z",
"last_activity_at": "2026-03-12T01:28:41.829924Z",
"folder": "primary",
"is_read": true,
"contact_id": "gAAAAABexampleContactIdReturnedByApi4pQ8xLm2sV7kRt1cN5hY9uJ3dF6"
}
],
"pagination": {
"limit": 25,
"cursor": null,
"next_cursor": null,
"has_more": false
}
}
GET /api/v2/organizations/{organization_id}/agents/{agent_id}/sales
{
"data": [
{
"sale_id": "gAAAAABexampleSaleIdReturnedByApi2xLm8dV4kTr7cY1hJ5uN9qP3",
"associated_conversation_ids": [
"gAAAAABexampleConversationIdReturnedByApi8kP3xLs7dV2mTr5cN9hY1uJ4"
],
"company_id": "gAAAAABexampleCompanyIdReturnedByApi6vT2mQ9xLs4dK7pNc1hY5uJ8rF3",
"owner_id": "gAAAAABexampleAgentIdReturnedByApi5qN8xLm3sV6kRt2cY9hJ4uW1dF7",
"associated_contacts": [
{
"contact_id": "gAAAAABexampleContactIdReturnedByApi4pQ8xLm2sV7kRt1cN5hY9uJ3dF6",
"is_primary": true
}
],
"quote_details": {
"output": {
"currency": "USD",
"total_price": "1200.00"
},
"arguments": {
"products": [
{
"quantity": 1,
"unit_price": "1200.00",
"product_name": "Legacy Seed Service"
}
]
}
},
"notes": "Backfilled sale for new sales framework compatibility.",
"current_status": {
"label": "Accepted",
"status": "accepted",
"changed_at": "2026-03-13T01:28:41.829924Z"
},
"status_history": [
{
"label": "Qualified",
"status": null,
"changed_at": "2026-03-12T01:28:41.829924Z"
},
{
"label": "Quoted",
"status": "quote_sent",
"changed_at": "2026-03-12T01:43:41.829924Z"
},
{
"label": "Accepted",
"status": "accepted",
"changed_at": "2026-03-13T01:28:41.829924Z"
}
],
"created_at": "2026-03-12T01:28:41.829924Z",
"last_activity_at": "2026-03-12T01:28:41.829924Z"
}
],
"pagination": {
"limit": 25,
"cursor": null,
"next_cursor": null,
"has_more": false
}
}
GET /api/v2/organizations/{organization_id}/agents/{agent_id}/analytics
{
"conversations": {
"conversationsRespondedTo": 42,
"messagesSent": 118
},
"sales": {
"pipeline": [
{
"name": "Qualified",
"status": null,
"volume": 24,
"value": "28800.00"
},
{
"name": "Quoted",
"status": "quote_sent",
"volume": 18,
"value": "21600.00"
},
{
"name": "Accepted",
"status": "accepted",
"volume": 11,
"value": "13200.00"
}
],
"salesRate": 0.46
}
}
GET /api/v2/organizations/{organization_id}/agents/{agent_id}/analytics/conversations
{
"conversationsRespondedTo": 42,
"messagesSent": 118
}
GET /api/v2/organizations/{organization_id}/agents/{agent_id}/analytics/sales
{
"pipeline": [
{
"name": "Qualified",
"status": null,
"volume": 24,
"value": "28800.00"
},
{
"name": "Quoted",
"status": "quote_sent",
"volume": 18,
"value": "21600.00"
},
{
"name": "Accepted",
"status": "accepted",
"volume": 11,
"value": "13200.00"
}
],
"salesRate": 0.46
}
Conversations and Messages
GET /api/v2/organizations/{organization_id}/conversations
{
"data": [
{
"conversation_id": "gAAAAABexampleConversationIdReturnedByApi8kP3xLs7dV2mTr5cN9hY1uJ4",
"start_at": "2026-04-29T14:00:00Z",
"last_activity_at": "2026-04-29T16:00:00Z",
"folder": "inbox",
"is_read": false,
"contact_id": "gAAAAABexampleContactIdReturnedByApi4pQ8xLm2sV7kRt1cN5hY9uJ3dF6"
}
],
"pagination": {
"limit": 25,
"cursor": null,
"next_cursor": null,
"has_more": false
}
}
GET /api/v2/organizations/{organization_id}/conversations/{conversation_id}
{
"conversation_id": "gAAAAABexampleConversationIdReturnedByApi8kP3xLs7dV2mTr5cN9hY1uJ4",
"start_at": "2026-04-29T14:00:00Z",
"last_activity_at": "2026-04-29T16:00:00Z",
"folder": "inbox",
"is_read": false,
"contact_id": "gAAAAABexampleContactIdReturnedByApi4pQ8xLm2sV7kRt1cN5hY9uJ3dF6"
}
GET /api/v2/organizations/{organization_id}/conversations/{conversation_id}/messages
{
"data": [
{
"message_id": "gAAAAABexampleMessageIdReturnedByApi9mT4xLs2qV7kRc5dN1hY8uJ3pF6",
"conversation_id": "gAAAAABexampleConversationIdReturnedByApi8kP3xLs7dV2mTr5cN9hY1uJ4",
"agent_id": null,
"modality": "email",
"message_direction": "sent",
"is_form_request": false,
"subject": "Following up on your inquiry",
"content": "Hi Diana, just checking in on the quote we sent over last week.",
"call_transcript": null,
"form_request_body": null,
"sent_at": "2026-04-29T15:02:00Z",
"drafted_at": null,
"email_metadata": {
"email_message_id": "<[email protected]>",
"cc_emails": [],
"bcc_emails": []
},
"call_metadata": {
"duration": null
},
"tracked_links": [
{
"link_id": "gAAAAABexampleTrackedLinkIdReturnedByApi3kL9xPs4qR2mTc7dN5hY8uV1",
"url": "https://example.com/quote",
"click_count": 3
}
]
}
],
"pagination": {
"limit": 50,
"cursor": null,
"next_cursor": null,
"has_more": false
}
}
GET /api/v2/organizations/{organization_id}/conversations/{conversation_id}/messages/{message_id}
{
"message_id": "gAAAAABexampleMessageIdReturnedByApi9mT4xLs2qV7kRc5dN1hY8uJ3pF6",
"conversation_id": "gAAAAABexampleConversationIdReturnedByApi8kP3xLs7dV2mTr5cN9hY1uJ4",
"agent_id": null,
"modality": "email",
"message_direction": "sent",
"is_form_request": false,
"subject": "Following up on your inquiry",
"content": "Hi Diana, just checking in on the quote we sent over last week.",
"call_transcript": null,
"form_request_body": null,
"sent_at": "2026-04-29T15:02:00Z",
"drafted_at": null,
"email_metadata": {
"email_message_id": "<[email protected]>",
"cc_emails": [],
"bcc_emails": []
},
"call_metadata": {
"duration": null
},
"tracked_links": [
{
"link_id": "gAAAAABexampleTrackedLinkIdReturnedByApi3kL9xPs4qR2mTc7dN5hY8uV1",
"url": "https://example.com/quote",
"click_count": 3
}
]
}
Message Drafts
POST /api/v2/organizations/{organization_id}/messages-drafts
{
"draft_id": "gAAAAABexampleDraftIdReturnedByApi6pN8xLm3sV7kRt2cY5hJ9uW1dF4",
"queued_to_send": false,
"send_at": null,
"folder": "drafts"
}
Analytics
GET /api/v2/organizations/{organization_id}/analytics/conversations
{
"responseRateStats": {
"numConversationsRespondedTo": 14,
"numConversationsReceived": 20,
"responseRate": 0.7
},
"responseTimeStats": {
"responseTime": 3600
},
"volumeStats": {
"numMessagesReceived": 120,
"numMessagesSent": 118,
"totalConversations": 42
},
"modalityStats": {
"textMessages": 10,
"calls": 4,
"emails": 20,
"liveChats": 6,
"formRequests": 2
}
}
GET /api/v2/organizations/{organization_id}/analytics/conversations/response-rate
{
"numConversationsRespondedTo": 14,
"numConversationsReceived": 20,
"responseRate": 0.7
}
GET /api/v2/organizations/{organization_id}/analytics/conversations/response-time
{
"responseTime": 3600
}
GET /api/v2/organizations/{organization_id}/analytics/conversations/volume
{
"numMessagesReceived": 120,
"numMessagesSent": 118,
"totalConversations": 42
}
GET /api/v2/organizations/{organization_id}/analytics/conversations/modality
{
"textMessages": 10,
"calls": 4,
"emails": 20,
"liveChats": 6,
"formRequests": 2
}
GET /api/v2/organizations/{organization_id}/analytics/sales
{
"pipeline": [
{
"name": "Qualified",
"status": null,
"volume": 24,
"value": "28800.00"
},
{
"name": "Quoted",
"status": "quote_sent",
"volume": 18,
"value": "21600.00"
},
{
"name": "Accepted",
"status": "accepted",
"volume": 11,
"value": "13200.00"
}
],
"salesRate": 0.46
}
Sales
GET /api/v2/organizations/{organization_id}/sales
{
"data": [
{
"sale_id": "gAAAAABexampleSaleIdReturnedByApi2xLm8dV4kTr7cY1hJ5uN9qP3",
"associated_conversation_ids": [
"gAAAAABexampleConversationIdReturnedByApi8kP3xLs7dV2mTr5cN9hY1uJ4"
],
"company_id": "gAAAAABexampleCompanyIdReturnedByApi6vT2mQ9xLs4dK7pNc1hY5uJ8rF3",
"owner_id": "gAAAAABexampleAgentIdReturnedByApi5qN8xLm3sV6kRt2cY9hJ4uW1dF7",
"associated_contacts": [
{
"contact_id": "gAAAAABexampleContactIdReturnedByApi4pQ8xLm2sV7kRt1cN5hY9uJ3dF6",
"is_primary": true
}
],
"quote_details": {
"output": {
"currency": "USD",
"total_price": "1200.00"
},
"arguments": {
"products": [
{
"quantity": 1,
"unit_price": "1200.00",
"product_name": "Legacy Seed Service"
}
]
}
},
"notes": "Backfilled sale for new sales framework compatibility.",
"current_status": {
"label": "Accepted",
"status": "accepted",
"changed_at": "2026-03-13T01:28:41.829924Z"
},
"status_history": [
{
"label": "Qualified",
"status": null,
"changed_at": "2026-03-12T01:28:41.829924Z"
},
{
"label": "Quoted",
"status": "quote_sent",
"changed_at": "2026-03-12T01:43:41.829924Z"
},
{
"label": "Accepted",
"status": "accepted",
"changed_at": "2026-03-13T01:28:41.829924Z"
}
],
"created_at": "2026-03-12T01:28:41.829924Z",
"last_activity_at": "2026-03-12T01:28:41.829924Z"
}
],
"pagination": {
"limit": 25,
"cursor": null,
"next_cursor": "next_cursor_from_previous_response",
"has_more": true
}
}
GET /api/v2/organizations/{organization_id}/sales/{sale_id}
{
"sale_id": "gAAAAABexampleSaleIdReturnedByApi2xLm8dV4kTr7cY1hJ5uN9qP3",
"associated_conversation_ids": [
"gAAAAABexampleConversationIdReturnedByApi8kP3xLs7dV2mTr5cN9hY1uJ4"
],
"company_id": "gAAAAABexampleCompanyIdReturnedByApi6vT2mQ9xLs4dK7pNc1hY5uJ8rF3",
"owner_id": "gAAAAABexampleAgentIdReturnedByApi5qN8xLm3sV6kRt2cY9hJ4uW1dF7",
"associated_contacts": [
{
"contact_id": "gAAAAABexampleContactIdReturnedByApi4pQ8xLm2sV7kRt1cN5hY9uJ3dF6",
"is_primary": true
}
],
"quote_details": {
"output": {
"currency": "USD",
"total_price": "1200.00"
},
"arguments": {
"products": [
{
"quantity": 1,
"unit_price": "1200.00",
"product_name": "Legacy Seed Service"
}
]
}
},
"notes": "Backfilled sale for new sales framework compatibility.",
"current_status": {
"label": "Accepted",
"status": "accepted",
"changed_at": "2026-03-13T01:28:41.829924Z"
},
"status_history": [
{
"label": "Qualified",
"status": null,
"changed_at": "2026-03-12T01:28:41.829924Z"
},
{
"label": "Quoted",
"status": "quote_sent",
"changed_at": "2026-03-12T01:43:41.829924Z"
},
{
"label": "Accepted",
"status": "accepted",
"changed_at": "2026-03-13T01:28:41.829924Z"
}
],
"created_at": "2026-03-12T01:28:41.829924Z",
"last_activity_at": "2026-03-12T01:28:41.829924Z"
}
Legacy v1 Routes
GET /api/v1/solutions
[
{
"uuid": "550e8400-e29b-41d4-a716-446655440000",
"name": "Acme Roofing"
}
]
GET /api/v1/solutions/{solution_id}/analytics
{
"responseRateStats": {
"numChatsSent": 0,
"numPendingChats": 0,
"responseRate": 0
},
"responseTimeStats": {
"responseTime": 0,
"responseTimeBusinessHours": 0,
"numResponses": 0,
"numResponsesBusinessHours": 0
},
"salesStats": {
"averageSpeedToSale": 0,
"numSalesCounted": 0
},
"valueStats": {
"salesValue": 0,
"quoteValue": 0
},
"salesFunnelStats": {
"source": {
"sessionsDirectEmail": 0,
"sessionsIndirectEmail": 0,
"sessionsFormRequest": 0
},
"response": {
"sessionsLeadResponded": 0,
"sessionsGhosted": 0,
"sessionsResponseSent": 0,
"sessionsPendingOutreach": 0
},
"outcome": {
"sessionsQuoted": 0
},
"sale": {
"sessionsSale": 0
}
},
"autonomyRateStats": {
"chatsSentWithChanges": 0,
"chatsSentWithoutChanges": 0,
"autonomyRate": 0
},
"numLeads": 0,
"leadsHandled": 0,
"salesRate": 0,
"quoteRate": 0,
"ghostRate": 0,
"leadResponseScore": 0
}