---
title: "Get per-signal breakdown"
method: GET
path: "/jobs/{job_id}/signals"
tags: ["jobs"]
---

# Get per-signal breakdown

`GET /jobs/{job_id}/signals`

## Request

- Base URL: `https://api.whoisgeni.us` (the document declares no server; this is the origin it was published from)
- URL: `https://api.whoisgeni.us/jobs/{job_id}/signals`
- Auth: none declared

Get the per-entity signal breakdown for a completed job.

Provides full transparency into how entities were scored. Each entity
includes its individual signal contributions and cross-signal correlations
from the scoring engine output stored in the AnalysisRun JSONB.

Available to all tiers (output is no longer tier-gated). Returns 404 if
the job does not exist, 409 if the analysis is still in progress, and the
full signal breakdown when complete. Internal signal weights are never
included in the response schema.

## Path parameters

- `job_id` string, required

## Headers

- `X-API-Key` string, nullable

## Response `200`

Successful Response

- ApiResponseSignalsResponse
  - `data` SignalsResponse: Top-level response for the signal breakdown endpoint. Provides full transparency into how entities were scored for a given domain analysis. Attributes: job_id: The job whose signals are being displayed. domain: The domain that was analyzed. entities: Per-entity signal breakdowns. missing_signals: Signals that could not be collected.
    - `job_id` string, required
    - `domain` string, nullable
    - `entities` EntitySignalBreakdown[], required
      - `entity` EntitySummary, required: Compact entity representation for signal breakdown responses. Attributes: name: Canonical normalized entity name. display_name: Best raw entity name preserving original casing. entity_type: Classification (organization, person, unknown). confidence: Computed confidence score from 0.0 to 1.0.
        - `name` string, required
        - `display_name` string, required
        - `entity_type` string, required
        - `confidence` number, required
      - `signals` SignalDetail[], required
        - `signal_type` string, required
        - `field` string, required
        - `raw_value` string, required
        - `collector_confidence` number, required
        - `contribution` number, required
        - `redacted` boolean
      - `correlations` object[]
    - `missing_signals` object[]
  - `error` ErrorDetail: Structured error information for API error responses. Attributes: code: Machine-readable error code (e.g. "JOB_NOT_FOUND"). message: Human-readable error description. details: Optional additional context for debugging.
    - `code` string, required
    - `message` string, required
    - `details` object, nullable
  - `meta` object, nullable

## Other responses

- `401`: Unauthorized — missing or invalid API key/JWT.
- `404`: Job not found
- `409`: Analysis not yet complete
- `422`: Validation Error

---

[API](https://skmtc.dev/whoisgeni/apis/whoisgenius.md) · [All operations](https://skmtc.dev/whoisgeni/apis/whoisgenius/llms.txt) · [OpenAPI document](https://skmtc.dev/whoisgeni/apis/whoisgenius/revisions/707f1c34f6b3?raw)