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
const url = 'https://api.pitch2sale.com/api/v1/ai-journey/needs-you?limit=20';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}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).
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”cursor
string
limit
integer
Responses
Section titled “Responses”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
consent_badge
required
string
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" } ]}