Skip to main content
GET
/
v1
/
covenants
Search Covenants
curl --request GET \
  --url https://api.example.com/v1/covenants

​
Overview

Search and filter structured covenant data extracted from credit agreements and indentures. Returns financial covenants (leverage ratios, coverage tests), negative covenants (liens, asset sales), and protective covenants (change of control).

​
Request

​
Company Filters

​
ticker
string
Filter by company ticker.Example: CHTR

​
Covenant Filters

​
covenant_type
string
Filter by covenant type: financial, negative, incurrence, protective
​
test_metric
string
Filter by financial metric: leverage_ratio, first_lien_leverage, interest_coverage, fixed_charge_coverage
​
min_threshold
number
Minimum threshold value.
​
max_threshold
number
Maximum threshold value.
​
has_step_down
boolean
Filter for covenants with scheduled tightening.

​
Response Options

​
fields
string
Comma-separated fields to return.Example: covenant_name,threshold_value,threshold_type
​
limit
integer
default:"50"
Results per page. Maximum 100.
​
offset
integer
default:"0"
Pagination offset.

​
Covenant Types

TypeDescriptionExamples
financialMaintenance or incurrence tests with numerical thresholdsLeverage ratio, interest coverage
negativeRestrictions on company actionsLimitations on liens, debt, asset sales
incurrenceTests applied when taking specific actionsDebt incurrence ratio
protectiveBondholder protection provisionsChange of control, make-whole

​
Test Metrics

MetricDescription
leverage_ratioTotal Debt / EBITDA
first_lien_leverageFirst Lien Debt / EBITDA
secured_leverageSecured Debt / EBITDA
net_leverage_ratioNet Debt / EBITDA
interest_coverageEBITDA / Interest Expense
fixed_charge_coverage(EBITDA - CapEx) / Fixed Charges

​
Examples

​
Find Leverage Covenants

curl "https://api.debtstack.ai/v1/covenants?covenant_type=financial&test_metric=leverage_ratio" \
  -H "X-API-Key: ds_xxxxx"

​
Response

{
  "data": [
    {
      "id": "3be913dd-b4a7-4af6-8333-271caea2283c",
      "ticker": "CHTR",
      "company_name": "Charter Communications, Inc.",
      "instrument_name": "Term A-7 Loan",
      "cusip": null,
      "covenant_type": "incurrence",
      "covenant_name": "Leverage Ratio Incurrence Test",
      "test_metric": "leverage_ratio",
      "threshold_value": 6.0,
      "threshold_type": "maximum",
      "test_frequency": "incurrence",
      "description": "The Company may incur Indebtedness if the Leverage Ratio would be not greater than 6.0 to 1.0",
      "has_step_down": false,
      "step_down_schedule": null,
      "cure_period_days": null,
      "put_price_pct": null,
      "extraction_confidence": 0.95,
      "source_document_date": "2024-12-09"
    }
  ],
  "meta": {
    "total": 125,
    "limit": 50,
    "offset": 0,
    "covenant_types": ["financial", "negative", "incurrence", "protective"]
  }
}

​
More Examples

​
Company’s All Covenants

curl "https://api.debtstack.ai/v1/covenants?ticker=CHTR" \
  -H "X-API-Key: ds_xxxxx"

​
Change of Control Provisions

curl "https://api.debtstack.ai/v1/covenants?covenant_type=protective" \
  -H "X-API-Key: ds_xxxxx"

​
Tight Leverage Covenants (under 5x)

curl "https://api.debtstack.ai/v1/covenants?test_metric=leverage_ratio&max_threshold=5.0" \
  -H "X-API-Key: ds_xxxxx"