Get prospect details

Returns details of a specific prospect conversation

GET /prospects/{chatId}

Get Prospect Details

cURL

curl --request GET \
  --url https://api.kakiyo.com/v1/prospects/{chatId} \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "chat_12345abcde",
  "status": 2,
  "qualification": "inProgress",
  "paused": false,
  "lastMessage": "2023-06-15T15:30:00Z",
  "campaign": {
    "id": "campaign_12345abcde",
    "name": "Q2 Sales Outreach"
  },
  "prospect": {
    "id": "prospect_12345abcde",
    "name": "John Smith",
    "url": "https://linkedin.com/in/johnsmith",
    "headline": "VP of Sales at Acme Inc",
    "currentCompanyName": "Acme Inc",
    "currentJobTitle": "VP of Sales",
    "currentCompanyWebsite": "https://www.acme.com",
    "currentCompanyLinkedInUrl": "https://www.linkedin.com/company/acme",
    "location": {
      "city": "San Francisco",
      "country": "United States"
    },
    "about": "Experienced sales leader with over 15 years in the software industry..."
  },
  "messages": [
    {
      "role": "assistant",
      "content": "Hi John, I noticed you're leading the sales team at Acme Inc. I wanted to reach out because we've been helping companies like yours improve their response rates on cold outreach. Would you be open to a quick chat about how we might be able to help?",
      "date": "2023-06-15T10:30:00Z"
    }
  ]
}

The prospect object includes current company data when available from enrichment:

• currentCompanyName
• currentJobTitle
• currentCompanyWebsite
• currentCompanyLinkedInUrl

Authorizations

Authorization · string · header · required

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

Path Parameters

chatId · string · required

ID of the chat/conversation

Response

200

application/json

Prospect details

id · string

Example:

"chat_12345abcde"

status · enum<integer>

Available options: 0, 1, 2, 3, 4, 5

Example:

2

qualification · enum<string>

Available options: unqualified, needVerification, inProgress, qualified

Example:

"inProgress"

paused · boolean

Example:

false

lastMessage · string<date-time>

Example:

"2023-06-15T15:30:00Z"

campaign · object

Show child attributes

prospect · object

Show child attributes

messages · object[]

Show child attributes