Get Score History
securityscorecard.get_company_score_history
ActionBusiness appsconnection required
Calls the SecurityScorecard API with the connection's credentials.
Read how a company's overall score moved over a period of time.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- SecurityScorecard
- Secret shape
- the API token, or {"api_token": "…"}
- Config it needs
- base_url
- Resolved by
- config.connection_id, else node.connection_id
Configuration
4 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
scorecard_identifier The company's primary domain, which is how SecurityScorecard identifies a scorecard. | string | Yes | — | — | example.com |
timing How finely to sample the history; SecurityScorecard defaults to daily. | string | No | — | one of "daily", "weekly", "monthly" | — |
date_from The first date to report, written as YYYY-MM-DD. | string | No | — | matches ^\d{4}-\d{2}-\d{2}$ | 2026-01-01 |
date_to The last date to report, written as YYYY-MM-DD. | string | No | — | matches ^\d{4}-\d{2}-\d{2}$ | 2026-03-31 |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"date_from": "2026-01-01",
"date_to": "2026-03-31",
"scorecard_identifier": "example.com"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
history One entry per sampled date, oldest first. | array | — |
history[].date The date the score was effective on. | string | — |
history[].score The company's score on that date. | number | — |
history[].domain The company the score belongs to. | string | — |
count How many samples the response carried. | number | — |
scorecard_identifier The company the history was read for. | string | — |
{
"count": 0,
"history": [
{
"date": "",
"domain": "",
"score": 0
}
],
"scorecard_identifier": ""
}Notes
- Comparing the first and last entry is how a score-drop alert is built.
See Get Score History run in a workflow.
In a technical demo we add the SecurityScorecard connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.