Customer REST

List visible lead signals with safe lead, post, and watched-profile context.

Changed on
get/customer/leads/signals

Request

Query parameters

limitinteger

Number of items to return. The default is 50 and the maximum is 100.

cursorstring

Opaque cursor returned in page.nextCursor. Pass it unchanged with the same filters and sort. Incompatible cursors return validation_failed.

leadIdstring uuid
monitoredProfileIdstring uuid
monitoredProfileIdsstring

Comma-separated monitored profile IDs. Accepts up to 50 IDs.

postIdstring uuid
engagementType'LIKE' | 'COMMENT' | 'REPOST' | 'POST_AUTHOR'
engagementTypesstring

Comma-separated engagement types. Accepts up to 4 values.

dateFromstring date-time

Inclusive start of the date range.

dateTostring date-time

Inclusive end of the date range.

minIcpMatchPercentinteger
maxIcpMatchPercentinteger
disposition'ACTIVE' | 'CLIENT' | 'BAD_LEAD'
querystring
companyNamesstring

Comma-separated company names. Accepts up to 25 values.

profileType'TEAMMATE' | 'COMPETITOR' | 'INFLUENCER' | 'INVESTOR' | 'CUSTOM' | 'TARGET_ACCOUNT' | 'CUSTOMER' | 'PARTNER'
relationshipLabelstring
origin'agent' | 'watchlist' | 'all'

Safe lead origin. agent includes automated Agent and preview discovery; watchlist includes watched-profile and manual workflows.

Response

Lead engagement page with a nullable canonical signal on each record and lead.

Changes

    • info

      added the new enum value CUSTOMER to the query request parameter profileType

    • info

      added the new enum value PARTNER to the query request parameter profileType

    • info

      added the new enum value TARGET_ACCOUNT to the query request parameter profileType

    • breaking

      the response's body type changed from object to no type for status

    • breaking

      removed the required property from the response with the status

    • breaking

      removed the required property from the response with the status

    • info

      added the new enum value POST_AUTHOR to the query request parameter engagementType

    • info

      added subschema #2 to the response body allOf list for the response status