get_employer_activity_summary

All MCP toolsRead

Start with this for the participation snapshot: the caller organization's activity summary over the two fixed windows — all-time and last 30 days (event time): impressions (total and per surface), interest received and sent, selection records opened (erasure-proof), and match-outcome counts. Only positive engagement exists in this shape — negative/weak interest verbs and availability signals are structurally absent. An organization with no events reads all zeros. This summary is served to agents only — the web shows participation and progress on /report and the home board through their own read models. For per-job drill-down use list_job_pipelines (live counts) or list_job_funnel_summaries (reached stages).

Input schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output schema

{
  "type": "object",
  "properties": {
    "summary": {
      "type": "object",
      "properties": {
        "total": {
          "type": "object",
          "properties": {
            "impressions": {
              "type": "object",
              "properties": {
                "total": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991,
                  "description": "Ranked-exposure events shown in this window (ADR-0072)."
                },
                "bySurface": {
                  "type": "object",
                  "propertyNames": {
                    "type": "string"
                  },
                  "additionalProperties": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "description": "Impressions per surface. The surface vocabulary is free (locked in the writers, not a schema enum); a surface with no events in the window reads as 0."
                }
              },
              "required": [
                "total",
                "bySurface"
              ],
              "additionalProperties": false,
              "description": "Ranked-exposure counts, overall and per surface."
            },
            "interestsReceived": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Candidate interest toward the organization's jobs (person_to_job × interested only — negative and weak verbs are structurally absent from this report)."
            },
            "interestsSent": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "The organization's own outward interest verbs (job_to_person × interested only)."
            },
            "applications": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Distinct candidacies ever created (live rows ∪ erased-but-transitioned history) — person erasure never shrinks it."
            },
            "outcomes": {
              "type": "object",
              "properties": {
                "mutual_interest": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991,
                  "description": "Event count in this window (zero-filled)."
                },
                "agreed": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991,
                  "description": "Event count in this window (zero-filled)."
                },
                "hired": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991,
                  "description": "Event count in this window (zero-filled)."
                },
                "withdrawn": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991,
                  "description": "Event count in this window (zero-filled)."
                },
                "declined": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991,
                  "description": "Event count in this window (zero-filled)."
                }
              },
              "required": [
                "mutual_interest",
                "agreed",
                "hired",
                "withdrawn",
                "declined"
              ],
              "additionalProperties": false,
              "description": "Match-outcome counts, zero-filled over the locked 5-kind vocabulary."
            }
          },
          "required": [
            "impressions",
            "interestsReceived",
            "interestsSent",
            "applications",
            "outcomes"
          ],
          "additionalProperties": false,
          "description": "All-time counts."
        },
        "last30d": {
          "type": "object",
          "properties": {
            "impressions": {
              "type": "object",
              "properties": {
                "total": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991,
                  "description": "Ranked-exposure events shown in this window (ADR-0072)."
                },
                "bySurface": {
                  "type": "object",
                  "propertyNames": {
                    "type": "string"
                  },
                  "additionalProperties": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "description": "Impressions per surface. The surface vocabulary is free (locked in the writers, not a schema enum); a surface with no events in the window reads as 0."
                }
              },
              "required": [
                "total",
                "bySurface"
              ],
              "additionalProperties": false,
              "description": "Ranked-exposure counts, overall and per surface."
            },
            "interestsReceived": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Candidate interest toward the organization's jobs (person_to_job × interested only — negative and weak verbs are structurally absent from this report)."
            },
            "interestsSent": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "The organization's own outward interest verbs (job_to_person × interested only)."
            },
            "applications": {
              "type": "integer",
              "minimum": 0,
              "maximum": 9007199254740991,
              "description": "Distinct candidacies ever created (live rows ∪ erased-but-transitioned history) — person erasure never shrinks it."
            },
            "outcomes": {
              "type": "object",
              "properties": {
                "mutual_interest": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991,
                  "description": "Event count in this window (zero-filled)."
                },
                "agreed": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991,
                  "description": "Event count in this window (zero-filled)."
                },
                "hired": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991,
                  "description": "Event count in this window (zero-filled)."
                },
                "withdrawn": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991,
                  "description": "Event count in this window (zero-filled)."
                },
                "declined": {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 9007199254740991,
                  "description": "Event count in this window (zero-filled)."
                }
              },
              "required": [
                "mutual_interest",
                "agreed",
                "hired",
                "withdrawn",
                "declined"
              ],
              "additionalProperties": false,
              "description": "Match-outcome counts, zero-filled over the locked 5-kind vocabulary."
            }
          },
          "required": [
            "impressions",
            "interestsReceived",
            "interestsSent",
            "applications",
            "outcomes"
          ],
          "additionalProperties": false,
          "description": "Counts of the last 30 days (event time, not row-creation time)."
        }
      },
      "required": [
        "total",
        "last30d"
      ],
      "additionalProperties": false,
      "description": "The organization's participation report over the two fixed windows: all-time and last 30 days."
    }
  },
  "required": [
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}