---
title: "Warrant terms"
method: GET
path: "/v1/dilution/warrants"
---

# Warrant terms

`GET /v1/dilution/warrants`

## Request

- Base URL: `https://api.turos.app`
- URL: `https://api.turos.app/v1/dilution/warrants`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Find disclosed warrant terms and potential share overhang in offering materials.

## Query parameters

- `ticker` string
- `cik` string
- `accession_number` string
- `form_type` string
- `filed_at_from` string, date
- `filed_at_to` string, date
- `limit` integer
- `cursor` integer
- `view` 'agent'

## Response `200`

Successful response

- DilutionWarrantList
  - `object` 'list', required
  - `data` object[], required
    - `object` 'dilution_warrant', required
    - `id` string, required
    - `createdAt` string, required
    - `livemode` boolean, required
    - `ticker` string, nullable
    - `cik` string, required
    - `accessionNumber` string, required
    - `fileNo` string, nullable
    - `formType` string, nullable
    - `documentUrl` string, uri, required
    - `primaryFiling` boolean, required
    - `askedgarUrl` string, uri, nullable
    - `warrantsAmount` number, nullable
    - `warrantsRemaining` number, nullable
    - `warrantsExercisePrice` number, nullable
    - `conversionPrice` number, nullable
    - `sharePrice` number, nullable
    - `prefundedCost` number, nullable
    - `priceProtection` boolean, nullable
    - `ppClause` string, nullable
    - `registered` boolean, nullable
    - `underlyingSharesCalculated` number, nullable
    - `underlyingSharesRemaining` number, nullable
    - `convertibleDebtRemaining` number, nullable
    - `bank` string, nullable
    - `holders` object[], required
    - `headline` string, nullable
    - `summary` string, nullable
    - `notes` string, nullable
    - `filedAt` string, required
    - `exercisableDate` string, nullable
    - `maturityDate` string, nullable
    - `convertibleDate` string, nullable
    - `expirationDate` string, nullable
    - `updatedAt` string, required
    - `verification` object, required
      - `sourceSpan` string, nullable
      - `extractionTraceId` string, nullable
      - `confidence` number, nullable
      - `crossValidations` object[], required
        - `name` string, required
        - `passed` boolean, required
        - `expected` unknown
        - `actual` unknown
        - `deviation` number, nullable
      - `modelVersion` string, nullable
      - `verifiedAt` string, nullable
    - `provenance` object, required
      - `source` string, required
      - `sourceLabel` string
      - `sourceAgency` string
      - `canonicality` string
      - `fallbackPolicy` string
      - `accessionNumber` string, nullable, required
      - `filingUrl` string, uri, required
      - `acceptedAt` string, nullable
      - `retrievedAt` string, required
      - `parserVersion` string, required
    - `freshness` object
      - `status` 'fresh' | 'current' | 'archival' | 'stale' | 'degraded' | 'unknown', required
      - `asOf` string, required
      - `sourcePublishedAt` string, nullable
      - `lagMs` integer, nullable
      - `synthetic` boolean
    - `materialization` object
      - `parserVersion` string, required
      - `materializationVersion` string, required
    - `sourceRights` object, required
      - `source` string, required
      - `sourceLabel` string
      - `sourceAgency` string
      - `canonicality` string
      - `fallbackPolicy` string
      - `posture` 'public_safe' | 'contract_gated' | 'internal_only' | 'inventory_only' | 'review_required', required
      - `publicAvailability` 'public' | 'contract_gated' | 'internal_only' | 'inventory_only', required
      - `contractStatus` 'approved' | 'review_required' | 'restricted' | 'prohibited' | 'expired', required
      - `reviewOwner` string, nullable
      - `reviewedAt` string, nullable
      - `restrictions` string[], required
      - `notes` string, nullable
    - `methodology` object
      - `id` string, required
      - `version` string, required
      - `summary` string, required
      - `confidence` 'high' | 'medium' | 'low', required
      - `launchState` 'experimental' | 'beta' | 'ga', required
      - `inputs` string[], required
      - `validation` object
    - `revision` object
      - `sourcePublishedAt` string, nullable
      - `retrievedAt` string, required
      - `vintageId` string, nullable
      - `revisedFrom` string, nullable
    - `degradedState` object, nullable
      - `code` string, required
      - `message` string, required
      - `retryable` boolean, required
      - `missingCapabilities` string[], required
      - `fallbackUsed` string[], required
  - `hasMore` boolean, required
  - `nextCursor` string, nullable, required
  - `responseMode` 'compact' | 'standard' | 'verbose', nullable
  - `include` string[], nullable
  - `requestId` string, required

## Other responses

- `default`: Contract-aware error response

---

[API](https://skmtc.dev/turos/apis/turos-api.md) · [All operations](https://skmtc.dev/turos/apis/turos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/turos/apis/turos-api/revisions/a68d3ec80a56?raw)