Use the Dilution Score as a triage signal for an issuer, then inspect the cited filing-derived records before making a capital-structure conclusion. GET /v1/dilution/score requires a ticker and returns the current rating view; dilution routes return the SECAPI-Maturity: beta response header.
Dilution routes are beta. Coverage and extracted terms can be incomplete or unavailable for an issuer. Treat a returned rating as a research input, not a production-grade investment conclusion.
Get a rating
The response provides numericScore, overallRisk, factor breakdown, verification.confidence, freshness, provenance, and methodology context. Retain those fields with the response instead of reducing the result to a single number.
Use the rating with underlying records
Follow a rating with the records that can explain an issuer’s capital-structure risk:
For a filing-family view of registration statements and prospectuses, query offerings separately:
An offering or registration record is not proof that securities were issued, sold, freely tradable, or immediately dilutive. Read the cited filing for security terms, selling-holder context, conversion terms, exercise conditions, and later amendments.
Handle missing and degraded results
- Omitting
ticker from /v1/dilution/score returns a 400 missing_ticker error.
- An unresolved issuer returns a
404 dilution_score_not_found error.
- A route failure returns a
502 with a dilution-score lookup error code.
- List routes paginate; follow
nextCursor only while hasMore is true.
An empty list or a low verification.confidence input is not evidence that a security has no dilution risk. Preserve the response metadata and identify the source filing needed for a material conclusion.
Continue
