Conversations

Get an accessible inbox conversation and its current event version.

Returns a conversation accessible to the current user, including its current event version for tracking inbox updates.

get/conversations/{id}

Request

  • Base URL: https://api.leadping.ai
  • URL: https://api.leadping.ai/conversations/{id}
  • Auth: HTTP bearer

Path parameters

idstring required

The ID of the conversation to retrieve.

Response

OK

isDemoboolean
idstring

Unique Leadping identifier for this conversation response.

leadIdstring

Lead ID associated with this inbox conversation.

firstNamestring nullable

First name of the lead, user, or contact represented by this conversation response.

lastNamestring nullable

Last name of the lead, user, or contact represented by this conversation response.

emailstring email nullable

Email address used to resolve the lead's avatar when available.

avatarUrlstring uri nullable

Optional profile image URL explicitly associated with the lead.

lastSnippetstring nullable

Most recent message preview shown for the conversation.

lastEventAtstring date-time nullable

UTC timestamp when the most recent conversation event occurred.

eventVersioninteger

Monotonic event boundary. Mark-read requests must send the version the reader observed.

lastEventIsInternalNoteboolean

Indicates that the most recent conversation activity is an internal note.

status'needs_reply' | 'waiting' | 'failed' | 'open' nullable

Defines the customer-facing operational status for an inbox conversation.

statusReasonstring nullable

Human-readable reason explaining the current status of this conversation response.

archivedAtstring date-time nullable

UTC timestamp when this record was archived.

archiveReason0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 nullable

Defines why a lead was removed from the active working pipeline.

isArchivedboolean

Indicates whether the Leadping conversation has been archived.

nextStepstring nullable

Recommended next step to move this conversation response forward.

isUnreadboolean

Indicates whether the current user has unread activity in the conversation.

leadPhoneNumberstring nullable

Lead's phone number used for conversation matching and outreach.

outboundPhoneNumberOverrideIdstring nullable

Phone number ID manually chosen to override automatic outbound selection.

activeOutboundPhoneNumberIdstring nullable

Phone number ID currently active for outbound delivery.

Changes

No recorded changes to this operation across all 1 revision of this API.