> ## Documentation Index
> Fetch the complete documentation index at: https://docs.secapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Dilution score

> Retrieve a beta per-issuer dilution rating with numericScore, overallRisk, and filing-derived inputs needed for a review workflow

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.

<Warning>
  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.
</Warning>

## Get a rating

```bash theme={null}
curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/dilution/score?ticker=AAPL"
```

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:

```bash theme={null}
curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/dilution/events?ticker=AAPL&limit=25"
```

```bash theme={null}
curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/dilution/warrants?ticker=AAPL&limit=25"
```

```bash theme={null}
curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/dilution/convertibles?ticker=AAPL&limit=25"
```

For a filing-family view of registration statements and prospectuses, query offerings separately:

```bash theme={null}
curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/offerings?ticker=AAPL&forms=S-1,424B4&limit=10"
```

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

* [Dilution API reference](/api-reference/dilution)
* [Offerings API reference](/api-reference/offerings)
* [Ownership workflows](/ownership-workflows)