Skip to main content
GET
https://api.debtstack.ai
/
v1
/
companies
Search Companies
curl --request GET \
  --url https://api.debtstack.ai/v1/companies
{
  "data": [
    {}
  ],
  "meta": {
    "total": 123,
    "limit": 123,
    "offset": 123
  }
}

​
Overview

Search and filter companies by leverage, sector, debt metrics, and more. Supports field selection for optimized responses.

​
Request

​
ticker
string
Comma-separated list of tickers to filter by.Example: AAPL,MSFT,GOOGL
​
sector
string
Filter by sector.Example: Technology, Energy, Communication Services
​
industry
string
Filter by industry.Example: Software, Oil & Gas
​
min_leverage
number
Minimum leverage ratio (Total Debt / EBITDA).
​
max_leverage
number
Maximum leverage ratio.
​
min_net_leverage
number
Minimum net leverage ratio (Net Debt / EBITDA).
​
max_net_leverage
number
Maximum net leverage ratio.
​
min_debt
integer
Minimum total debt in cents.Example: 100000000000 ($1 billion)
​
max_debt
integer
Maximum total debt in cents.
​
has_structural_sub
boolean
Filter for companies with structural subordination.
​
has_floating_rate
boolean
Filter for companies with floating rate debt.
​
has_near_term_maturity
boolean
Filter for companies with debt maturing within 24 months.
​
fields
string
Comma-separated list of fields to return.Example: ticker,name,net_leverage_ratio
​
sort
string
Field to sort by. Prefix with - for descending.Example: -net_leverage_ratio
​
limit
integer
default:"50"
Number of results per page. Maximum 100.
​
offset
integer
default:"0"
Pagination offset.
​
include_metadata
boolean
default:"false"
Include extraction metadata (qa_score, timestamps, warnings).

​
Response

​
data
array
Array of company objects with requested fields.
​
meta
object

​
Examples

curl "https://api.debtstack.ai/v1/companies?ticker=AAPL,MSFT,GOOGL,AMZN,NVDA,META,TSLA&fields=ticker,name,net_leverage_ratio&sort=-net_leverage_ratio&limit=1" \
  -H "X-API-Key: ds_xxxxx"

​
Response

{
  "data": [
    {
      "ticker": "TSLA",
      "name": "Tesla, Inc.",
      "net_leverage_ratio": 1.8
    }
  ],
  "meta": {
    "total": 7,
    "limit": 1,
    "offset": 0,
    "filters_applied": {
      "ticker": ["AAPL", "MSFT", "GOOGL", "AMZN", "NVDA", "META", "TSLA"]
    }
  }
}

​
Use Cases

​
Find Highly Leveraged Companies

curl "https://api.debtstack.ai/v1/companies?min_leverage=4.0&fields=ticker,name,leverage_ratio,net_leverage_ratio&sort=-leverage_ratio" \
  -H "X-API-Key: ds_xxxxx"

​
Screen by Sector

curl "https://api.debtstack.ai/v1/companies?sector=Energy&has_floating_rate=true&fields=ticker,name,total_debt,secured_debt" \
  -H "X-API-Key: ds_xxxxx"

​
Near-Term Maturity Wall

curl "https://api.debtstack.ai/v1/companies?has_near_term_maturity=true&fields=ticker,name,debt_due_1yr,debt_due_2yr,nearest_maturity" \
  -H "X-API-Key: ds_xxxxx"