Skip to main content

​
Base URL

https://api.debtstack.ai/v1

​
Authentication

All requests require an API key in the X-API-Key header: 
curl "https://api.debtstack.ai/v1/companies" \
  -H "X-API-Key: ds_xxxxx"

​
Endpoints

DebtStack provides 11 core primitives for corporate debt analysis:

​
Companies

MethodEndpointDescriptionCost
GET/v1/companiesSearch and filter companies$0.05
GET/v1/companies/{ticker}/changesGet recent changes for a company$0.10

​
Bonds

MethodEndpointDescriptionCost
GET/v1/bondsSearch and filter bonds$0.05
GET/v1/bonds/resolveResolve CUSIP/ISIN to bond details$0.05

​
Financials

MethodEndpointDescriptionCost
GET/v1/financialsGet financial metrics and ratios$0.05

​
Collateral

MethodEndpointDescriptionCost
GET/v1/collateralGet collateral and security details$0.05

​
Covenants

MethodEndpointDescriptionCost
GET/v1/covenantsSearch covenant terms$0.05
GET/v1/covenants/compareCompare covenants across companiesBusiness only

​
Entities

MethodEndpointDescriptionCost
POST/v1/entities/traverseTraverse entity relationships$0.15

​
Documents

MethodEndpointDescriptionCost
GET/v1/documents/searchFull-text search SEC filings$0.15

​
Batch

MethodEndpointDescriptionCost
POST/v1/batchExecute multiple operationsSum of operations

​
Business-Only Endpoints

MethodEndpointDescription
GET/v1/bonds/{cusip}/pricing/historyHistorical bond pricing (up to 2 years)
GET/v1/exportBulk data export (up to 50,000 records)
GET/v1/usage/analyticsDetailed usage analytics

​
Response Format

​
Success

{
  "data": [...],
  "meta": {
    "total": 100,
    "limit": 50,
    "offset": 0,
    "request_id": "req_abc123"
  }
}

​
Error

{
  "error": {
    "code": "INVALID_TICKER",
    "message": "Company ticker 'XYZ' not found",
    "details": {
      "suggestion": "Did you mean 'XOM'?"
    }
  }
}

​
Common Parameters

These parameters are available on most list endpoints:
ParameterTypeDescription
fieldsstringComma-separated list of fields to return
sortstringSort field (prefix - for descending)
limitintegerResults per page (max 100)
offsetintegerPagination offset
formatstringResponse format: json (default) or csv

​
Rate Limits

TierLimitQueries
Pay-as-You-Go60 requests/minutePay per call
Pro100 requests/minuteUnlimited
Business500 requests/minuteUnlimited
Rate limit headers are included in all responses: 
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1706140800

​
Credit Usage (Pay-as-You-Go)

Each endpoint consumes credits based on complexity:
Endpoint TypeCostEndpoints
Simple$0.05Companies, Bonds, Resolve, Financials, Collateral, Covenants
Complex$0.10Company Changes
Advanced$0.15Traverse, Documents, Batch (per operation)
Pro and Business tiers have unlimited queries included.