Organization signals

Retrieve recent signals for a single organization

Retrieve the recent signals for a single organization: champion movements, recent hires and promotions, technology and product mentions, projects and initiatives, technology and job function trends. Use this endpoint when you already have the Sumble organization id.

Input

Pass the Sumble organization id in the URL path:

curl https://api.sumble.com/v9/organizations/1726684/signals \
  --header "Authorization: Bearer $API_KEY"

The endpoint does not accept a request body. If the organization does not exist, the API returns HTTP 404.

Response

The response contains a signals array. Each signal includes a display-ready title, display_type, and date, plus optional context such as subtitle, type, organization_name, organization_id, location, job_function, priority, explanation, and sales_angle.

For person-movement signals, subtitle may include a normalized start-date label such as Started Jun 2026 or Starting Jul 2026.

File download

Set the file_name query parameter to a filename ending in .csv, .xlsx for an Excel workbook, or .json, to download the organization's signals. The file contains one row per signal and one column per response field. matched_technologies and suggested_contacts contain compact JSON text within their cells in a .csv or .xlsx, and stay nested in a .json.

The response keeps its credit metadata, adds an authenticated Sumble download URL and file details, and returns an empty signals array because the rows are in the file. Ask Sumble and Slack attach the file automatically. Other MCP clients should present the download URL instead of recreating the file with code execution.

Credit cost

1 credit per signal returned. Organizations with no returned signals do not consume credits.

Get organization signals

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organization_idintegerRequired

Query parameters

technology_slugsstring[] · nullableOptional

Technology slugs to filter signals by. Repeat this query parameter to filter by multiple technologies. Use POST /technologies/lookup to resolve technology names, slugs, or aliases to canonical slugs; use POST /technologies/find to search for matching technologies.

Responses

200

Successful Response

application/json

idstring · uuidRequired

credits_usedintegerRequired

credits_remainingintegerRequired

422

Validation Error

application/json

get/v9/organizations/{organization_id}/signals

GET /v9/organizations/{organization_id}/signals HTTP/1.1
Host: api.sumble.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "019c2a87-11f0-78b3-b82d-cdd178cf4018",
  "credits_used": 1,
  "credits_remaining": 998,
  "signals": [
    {
      "title": "Amazon hired Jane Doe",
      "subtitle": "Started Jun 2026",
      "explanation": "Jane Doe joined the platform team.",
      "sales_angle": "The team is expanding Kubernetes.",
      "date": "2026-06-17T12:00:00Z",
      "sumble_url": "https://sumble.com/orgs/amazon/signals/s/123",
      "display_type": "New hire using Kubernetes",
      "type": "technology_recent_hires",
      "organization_name": "Amazon",
      "organization_id": 1,
      "job_post_id": 789,
      "person_id": 456,
      "linkedin_url": "https://www.linkedin.com/in/jane-doe",
      "location": "Seattle, WA",
      "job_function": "Engineering",
      "priority": "high",
      "signal_config_id": 512,
      "signal_config_name": "Kubernetes hiring at my accounts"
    }
  ]
}