Skip to content
Developers
Get started
Early access: these pages are being written and reviewed. Facts in the header boxes come straight from the product.

List AI hand-offs that need a rep

GET
/api/v1/ai-journey/needs-you
curl --request GET \
--url 'https://api.pitch2sale.com/api/v1/ai-journey/needs-you?limit=20' \
--header 'Authorization: Bearer <token>'

New-lead journeys the AI handed to a human and nobody resolved yet, newest first, limited to the leads the caller may view. Each row has the lead, the last call (outcome, duration, whether a recording exists, a short AI summary), the consent badge and the call cost. No phone numbers, recording URLs or transcripts. Pass next_cursor back as cursor for the next page (limit at most 50).

cursor
string
>= 1 characters <= 200 characters
limit
integer
default: 20 >= 1 <= 50

A page of hand-offs

Media typeapplication/json
object
items
required
Array<object>
object
journey_id
required
string
state
required
string
lead
required
object
id
required
string
name
required
string | null
last_outcome
required
string | null
suggested_next_step
required
string | null
handed_to_human_at
required
string
last_call
required
Any of:
object
call_id
required
string
outcome
required
string | null
duration_seconds
required
number | null
has_recording
required
boolean
summary
required
string | null
consent_badge
required
string
Allowed values: explicit enquiry none
cost
required
Any of:
object
total_inr
required
number | null
carrier_inr
required
number | null
ai_inr
required
number | null
billed_seconds
required
number | null
next_cursor
required
string | null
Example
{
"items": [
{
"consent_badge": "explicit"
}
]
}

Validation failed

Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"details": [
{
"field": "example",
"message": "example",
"code": "example"
}
]
}

Authentication required or token invalid

Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"details": [
{
"field": "example",
"message": "example",
"code": "example"
}
]
}

Role permission or token scope missing; OAuth app tokens are not accepted on this route

Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"details": [
{
"field": "example",
"message": "example",
"code": "example"
}
]
}

Rate limit exceeded

Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{
"error": "example",
"code": "example",
"message": "example",
"details": [
{
"field": "example",
"message": "example",
"code": "example"
}
]
}