GET
/
v1
/
Outbound
/
{outboundId}
/
Lead
/
{leadId}
Get Lead
curl --request GET \
  --url https://api.nlpearl.ai/v1/Outbound/{outboundId}/Lead/{leadId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "externalId": "<string>",
  "phoneNumber": "<string>",
  "timeZone": "<string>",
  "status": 123,
  "created": "2023-11-07T05:31:56Z",
  "callsId": [
    "<string>"
  ],
  "lastCall": {
    "id": "<string>",
    "startTime": "2023-11-07T05:31:56Z",
    "pearlId": "<string>",
    "status": 123,
    "from": "<string>",
    "name": "<string>",
    "collectedData": {
      "transcript": [
        {
          "role": 123,
          "content": "<string>",
          "startTime": 123,
          "endTime": 123
        }
      ],
      "collectedInfos": [
        {
          "id": "<string>",
          "name": "<string>",
          "value": "<any>"
        }
      ]
    },
    "summary": "<string>",
    "duration": 123,
    "recording": "<string>",
    "tags": [
      "<string>"
    ]
  },
  "callData": {},
  "collectedData": {}
}

Authorizations

​
Authorization
string
header
required

Specify the authorization token.

For more information, check out the Authorization Guide.

Path Parameters

​
outboundId
string
required

The unique identifier of the outbound campaign.

​
leadId
string
required

The unique identifier of the lead within the outbound campaign.

Response

Details of the specific lead.

​
id
string | null

The unique identifier of the lead, represented as an ObjectId.

​
externalId
string | null

The identifier for the lead from an external system, such as a CRM.

​
phoneNumber
string | null

The phone number of the lead.

​
timeZone
string | null

The time zone of the lead, represented as a float (e.g., -5.0 for EST).

​
status
integer

The Status of the lead is the status of the last conversation.

To determine the definition of 'Success' or 'Not Successful,' please refer to the Create a Pearl page at step 4.

1 - New

10 - NeedRetry

20 - InCallQueue

30 - WrongCountryCode

40 - OnCall

70 - VoiceMailLeft

100 - Success

110 - NotSuccessfull

130 - Completed

150 - Unreachable

500 - Error

​
created
string<date-time>

The date and time when the lead was created.

​
callsId
string[] | null

The list of the ID's of all the calls this lead has received.

​
lastCall
object
​
callData
object | null

A dictionary containing additional information about the call. It is used as variables that you can use in "Opening Sentence" or "Flow Script" when you create a Pearl on the platform. The keys represent the field names, and the values contain the corresponding data. This information can be used to personalize the conversation or manage lead-specific details. This parameter is optional. see Variables for more information. Here is an exemple of the json to send: { "email" : "joe@gmail.com", "address": "3 Abbey Road UK" , "carLicense" : "90-929-82" }

​
collectedData
object | null

A dictionary containing all the information collected about the lead during the call.
These values are the result of the conversation and reflect the answers or actions taken by the lead.
The key represents the ID of the variable configured on the platform,
and the value corresponds to the collected data.

This information can be used to understand user intent, track specific responses, or power further automation.
For more details on how variables work, see Variables.

Here is an example of the JSON format: { "confirmBooking": true, "dropOffLocation": "Orly Airport", "rideTime": "Friday at 12:00", "userIntent": "Book a taxi to the airport" }