Riskify API Overview

Riskify delivers real‑time non‑financial risk intelligence through simple, scalable RESTful endpoints — designed for company risk profiling, risk signals, and batch monitoring.

View on Rapid
API overview illustration

Developer Benefits

Riskify API is built for modern engineering and data teams who need reliable, real‑time non‑financial risk intelligence.

  • Standardized JSON outputs for downstream analytics and storage
  • API‑first architecture with high availability and horizontal scalability
  • Global coverage across entities, sectors, and geographies
  • Continuous updates aligned with live news, regulatory, and ESG signals

Endpoints

Start with company‑risk for a unified non‑financial risk profile, then expand into detailed signals and batch monitoring as your workflow scales.

POST/create_scan_company_task
Creates a new company scan task. This endpoint initializes the scanning process by submitting the target company information and scheduling it for analysis.
POST/get_scan_company_result
Retrieves the scan results for a specific company task. This endpoint returns analysis data or insights generated from the previously created scan.

Response

Responses are returned as structured JSON, including risk dimension scores and the latest source‑linked signals.

Response · JSON
{
  "time": 1758164307,
  "profile": {},
  "count_warning": 0,
  "dimensions": {
    "news":{},
    "employees":{},
    "esg":{},
    "cybersecurity":{},
    "regulatory":{},
    "operational":{}
  },
  "references": []
}
Field
Type
Description
time
int
The timestamp indicating when the data was generated.
profile
object
The company profile information.
count_warning
int
The number of warnings detected.
dimensions
object
Contains data across six analytical dimensions.
references
array of object
Contains all related reference data sources.

Data Structures

Company Information (Profile) Data Structure

Field
Type
Description
linkedin_id
string
LinkedIn numeric company ID.
linkedin_key
string
Unique LinkedIn key (short company handle).
name
string
Company name.
avatar_url
string (URL)
Company avatar or logo image URL.
hq_country_code
string
Headquarters country code (ISO).
hq_country_name
string
Headquarters country name.
employee_range_name
string
Text representation of employee size range.
employee_range_id
string
Employee size range ID.
founded_year
string
Year the company was founded (string format).
website_home_url
string (URL)
Official homepage URL.
website_home_host
string
Hostname of the company website.
website_home_root
string
Root domain of the company website.
count_employee
int
Total number of employees.
count_follower
int
Number of LinkedIn followers.
description
string
Company description or summary.
industry_name
string
Industry name defined by LinkedIn.
specialties
array of string
List of business specialties or focus areas.
linkedin_url
string (URL)
URL of the company’s LinkedIn page.

Dimensions / News Data Structure

Field
Type
Description
tags
array of object
Contains all news-related tags or categories.
news_list
array of object
List of news articles related to the company or topic.

News Data Structure

Field
Type
Description
timestamp
int
Unix timestamp of when the news was published.
date
string
The publication date of the news article.
title
string
Title of the news article.
source
string
Source or publisher of the news article.
sentiment
int
Sentiment analysis score of the article:
-1 = Negative, 0 = Neutral, 1 = Positive.
link
string (URL)
URL link to the full news article.
tags
array of object
List of tag objects related to the news article.

News Tags Data Structure

Field
Type
Description
id
string
Unique tag identifier (ID).
text
string
Tag name or label text.
count
int
Number of news articles associated with this tag (default 0).

Dimensions / Employees Data Structure

Field
Type
Description
median_year
float
Average employee tenure in years.
change_6m
float
Employee count change rate in the past 6 months.
change_12m
int
Employee count change rate in the past 12 months.
monthly_count
array of object
Monthly employee count data for the past year.
new_decision_makers
array of object
Information about newly appointed executives or decision makers.

Monthly Count Object Data Structure

Field
Type
Description
date
string
Month represented in YYYY-MM format (e.g., 2025-09).
count
int
Number of employees during the given month.
timestamp
int
Unix timestamp corresponding to the month.

New Decision Makers Object Data Structure

Field
Type
Description
date
string
Date of the leadership change, in YYYY-MM-DD format (e.g., 2025-09-08).
count
int
Total number of employees at the time of the change.
timestamp
int
Unix timestamp corresponding to the given date.
subject
string
Title or summary describing the executive change.
link
string (URL)
LinkedIn profile URL of the executive involved.

Dimensions / ESG Data Structure

Field
Type
Description
certifications
array of object
List of ESG-related certifications or accreditations obtained by the company.

Certifications Data Structure

Field
Type
Description
name
string
Full name of the ESG certification.
short_name
string
Abbreviated or short version of the certification name.
description
string
A brief description of the certification or its purpose.
certified
int
Indicates whether the company holds this certification:
0 = No, 1 = Yes.

Dimensions / cybersecurity Data Structure

Field
Type
Description
standards
array of object
List of information security standards or compliance frameworks adopted by the company.
website_traffic_count
int
Estimated monthly website traffic volume.
website_traffic_change
float
Monthly change rate of website traffic (as a percentage).
website_traffic_top_countries
array of object
Distribution of website traffic by country, showing top contributing regions.
it_employees_changes_6m
float
Percentage change in IT department employee count over the past 6 months.
it_employees_changes_12m
float
Percentage change in IT department employee count over the past 12 months.

Standards Data Structure

Field
Type
Description
full_name
string
Full name of the information security standard.
short_name
string
Abbreviated or commonly used short name of the standard.
description
string
Short description or summary of the security standard.
certified
int
Indicates whether the company complies with this standard:
0 = No, 1 = Yes.

Dimensions / Regulatory Data Structure

Field
Type
Description
entity_list
array of object
List of sanctioned entities or individuals associated with the company.

Entity List Object Data Structure

Field
Type
Description
title
string
Name of the sanction list.
identifier
string
Unique ID or code identifying the sanction list.
publisher
string
The organization or authority that published the sanction list.
entities
string
Number of entities listed under this sanction list.
description
string
Description or summary of the sanction list.
listed
int
Indicates whether the company or entity appears on this sanction list:
0 = Not listed, 1 = Listed.

Dimensions / Operational Data Structure

Field
Type
Description
recent_disasters
array of object
List of recent natural disasters that may impact the region or company operations.
current_wars
array of object
List of ongoing wars or conflicts relevant to the company’s geographical exposure.

Recent Disasters Object Data Structure

Field
Type
Description
type
string
Type of the event (e.g., “earthquake”, “flood”, “war”, “conflict”).
name
string
Official or commonly used name of the event.
description
string
Description or summary of the event.
level
string
Severity or alert level of the event (e.g., “high”, “moderate”, “low”).
score
int
Weight or impact score assigned to the event.
countries
array of string
List of ISO country codes affected by the event.
lalo
array of number
Geographic coordinates (latitude and longitude) of the affected area.
time_from
int
Start time of the event (Unix timestamp).
time_to
int
End time of the event (Unix timestamp).
affected
int
Indicates whether the company or region was affected by this event:
0 = Not affected, 1 = Affected.

Current Wars Object Data Structure

Field
Type
Description
name
string
Name or title of the war or conflict.
lalos
array of array (number)
List of coordinate pairs ([latitude, longitude]) representing key locations of the conflict.
countries
array of string
List of countries involved in the war, represented by ISO2 country codes.
affected
int
Indicates whether the company or its region is affected by this war:
0 = Not affected, 1 = Affected.

Reference Object Data Structure

Field
Type
Description
title
string
Title of the referenced article or source.
link
string (URL)
URL link to the reference or original article.
source
string
The publication or organization that provided the source.
timestamp
int
Unix timestamp representing when the reference was published or retrieved.

Enumerations

News Tags

ID
Name
AWARDS
Awards
EVENT_APPEARANCES
Event Appearances
FINANCIAL_RISKS
Financial Risks
INNOVATION
Innovation & R&D
LAWSUITS
Lawsuits
LAYOFFS
Layoffs
LEGAL_COMPLIANCE_RISKS
Legal / Compliance Risks
MA_FINANCING
M&A / Financing
OPERATIONAL_RISKS
Operational Risks
REGULATORY_PENALTIES
Regulatory Penalties
SALARY_CUTS
Salary Cuts
SALARY_HIKES
Salary Increases
SANCTIONS
Sanctions
STRIKE
Strikes & Labor Disputes
SUPPLIER_PAYMENT_DELAYS
Supplier Payment Delays
UNPAID_WAGES
Unpaid Wages

Disaster Types

ID
Name
DR
Drought
EQ
Earthquake
FL
Flood
TC
Tropical Cyclone
TS
Tsunami
VO
Volcano
WF
Wildfire

Natural Disaster Alert Levels

ID
Name
GREEN
Green
ORANGE
Orange
RED
Red

Employee Size Range

ID
Name
A
Self-employed
B
1 ~ 10
C
11 ~ 50
D
51 ~ 200
E
201 ~ 500
F
501 ~ 1000
G
1001 ~ 5000
H
5001 ~ 10,000
I
10,001+

Ready to work with our API

Connect Riskify’s non‑financial risk intelligence to your systems through our Rapid‑hosted API and start enriching your risk workflows in days, not months.

Explore on Rapid