Sign in

v1

latestOpenAPI 3.0.3Proprietary2026-08-0656136286.9 KB
Signals

Contact Signals

Retrieve signal events for a list of contacts — job changes and promotions.

Pass up to 100 contact ids. Use signalTypes to specify which events to return (promotion, companyChange, or allSignals). Optionally set a startDate to limit results to recent activity.

Billing: Charged per matched signal per result via the showSignalsContact action.

Persisting to a table: Pass tableId to also add these contacts to an existing table and populate the Signals column. See Contacts Tables.

post/v3/contacts/signals

Request body

idsstring[] required
signalTypesstring[] required
startDatestring date
maxResultsPerSignalinteger
tableIdstring

Optional. If provided, these contacts are also added to this table (if not already present) and the Signals column is populated. See the Tables API.

Example request

{
  "ids": [
    "4389064624",
    "4389064654"
  ],
  "signalTypes": [
    "allSignals"
  ],
  "startDate": "2025-01-01",
  "maxResultsPerSignal": 10,
  "tableId": "482910"
}

Response

Successful response

startDatestring
endDatestring

Example response

{
  "results": [
    {
      "id": "4389064624"
    }
  ],
  "tableWrite": {
    "tableId": "482910",
    "added": 3,
    "alreadyPresent": 2,
    "rowsProcessed": 5,
    "rowsCharged": 5
  },
  "billing": {
    "creditsCharged": 3,
    "resultsReturned": 1
  }
}