Skip to main content
GET
Get the company risk timeline (v2)
Max+ tier The company’s risk over time, as data for a chart: what happened to the company month by month, and the model’s 12-month probability of bankruptcy at each month, scored only from what was known on that date. It is the data behind the risk timeline in TIC LENS. Months are counted from the as-of date: 0 is the month of the as-of date, -1 the month before it. A company younger than the window starts at its first known month. Unlike most LENS endpoints, its field names are in snake_case.

Parameters

Response

Rows

Events

Path

Each point is scored as of its own date, from the data that was known then, so a step in the path shows what changed the assessment at that time. The answer is cached for four hours. When the risk model is temporarily unavailable the endpoint returns 503.

Authorizations

x-api-key
string
header
required

Path Parameters

id
integer<int32>
required

Internal company ID

Query Parameters

monthsBack
integer<int32>
default:36

Months before the as-of date, at most 60. Default 36.

monthsForward
integer<int32>
default:12

Months after the as-of date, at most 24. Default 12.

step
integer<int32>
default:1

Months between two scored points, 1 to 6. Default 1.

asOf
string

The as-of date, YYYY-MM-DD. Default today.

Response

The company risk timeline