Quick Start

1. Create an AskEdgar account

If you don't already have one, sign up for an AskEdgar account. This is the same account you use across all AskEdgar products.

2. Get your API key

Head to the API Platform to generate your API key and manage credits. This is your hub for key management, usage tracking, and billing.

💳
You'll need credits on your account before making paid requests. Visit the API Platform to add credits, or use the pricing calculator to estimate costs.

3. Make your first request

All requests authenticate via the API-KEY header. Let's pull the dilution rating for a ticker:

curl "https://api.askedgar.com/v1/dilution-rating?ticker=AAPL" \
  -H "API-KEY: your_api_key"

import requests

resp = requests.get(
    "https://api.askedgar.com/v1/dilution-rating",
    params={"ticker": "AAPL"},
    headers={"API-KEY": "your_api_key"},
)
print(resp.json())

const resp = await fetch(
  "https://api.askedgar.com/v1/dilution-rating?ticker=AAPL",
  { headers: { "API-KEY": "your_api_key" } }
);
const data = await resp.json();
console.log(data);

You'll get back a response like this:

{
  "status": "success",
  "count": 1,
  "has_more": false,
  "page": 1,
  "limit": 10,
  "results": [
    {
      "ticker": "AAPL",
      "offering_ability": "Low",
      "dilution": "Medium",
      "offering_frequency": "Low",
      "cash_need": "Medium",
      "nasdaq_compliance": "Low",
      "overall_offering_risk": "Low",
      "regsho": false,
      "estimated_cash": 22440000.0,
      "cash_burn": 2900000.0,
      "cash_remaining_months": 23.23,
      ...
    }
  ]
}

4. Estimate costs before you query

The /estimate endpoint is free and unauthenticated — use it to check how much a request will cost before spending credits:

curl "https://api.askedgar.com/estimate?endpoint=dilution-rating&ticker=AAPL"

{
  "endpoint": "dilution-rating",
  "ticker_count": 1,
  "records_returned": 1,
  "estimated_cost_dollars": "$0.000115",
  ...
}

This is especially useful when querying across many tickers or pulling large date ranges. See the pricing calculator for a visual breakdown.

5. Understand the response format

Every endpoint returns the same structure:

Field	Type	Description
`status`	string	`"success"` or `"error"`
`count`	integer	Number of results in this page
`has_more`	boolean	Whether additional pages exist
`page`	integer	Current page number
`limit`	integer	Max results per page (default 10, max varies)
`results`	array	The data — schema varies by endpoint

To paginate, increment the page parameter:

/v1/dilution-data?ticker=AAPL&page=1&limit=25
/v1/dilution-data?ticker=AAPL&page=2&limit=25

Next steps

Authentication

API key details and security best practices

Error Handling

HTTP status codes, error shapes, and rate limits

API Reference

Browse all endpoints with interactive examples