reports

Generate a CSV containing Scorecard Domains

Changed on Nov 3, 2026

Note: requesting a report for a company where score is still calculating will be accepted,
but might fail to generate if a score is not determined soon enough.
It's recommended to check a score is available before requesting a report

post/reports/footprint-domains

Request

Base URL
https://api.securityscorecard.io
URL
https://api.securityscorecard.io/reports/footprint-domains
Auth
API key in header Authorization

Request body

domainstring required

primary domain of the company

assetsstring

Example request

{
  "domain": "example.com"
}

Response

a reference to the created report

idstring required

Identifier

formatstring

titlestring

report_typestring

created_atstring date-time

created date

is_newboolean

Example response

{
  "id": "aea7dae2-370f-4279-a458-4c7cb9661778",
  "params": {
    "domain": "example.com"
  },
  "created_at": "2020-01-01T00:00:00.000Z"
}

Changes

Nov 3, 2026b465b4846039 Revision changes
- info
  added the media type application/json for the response with the status
- info
  added the media type application/json for the response with the status
- info
  media type application/json; charset=utf-8 was changed to application/json for the response status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  the response property became required for the status
- info
  the response's property pattern ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ was added for the status

Operation history