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

> ## Agent Instructions
> The Financial Datasets API is served at https://api.financialdatasets.ai. Authenticate with the `X-API-KEY` header; create keys at https://financialdatasets.ai. Agents can open and fund their own account without a dashboard: see https://docs.financialdatasets.ai/agents.md.
> Tool-using agents can call Financial Datasets without writing code through the hosted MCP server at https://mcp.financialdatasets.ai/.
> The OpenAPI spec at https://financialdatasets.ai/openapi.json is the source of truth for request and response schemas.
> The index of every docs page is at https://docs.financialdatasets.ai/llms.txt. Append .md to any docs URL to get that page as Markdown.

# Insider Sale Notices API (SEC Form 144)

> SEC Form 144 notices of proposed insider stock sales: 130,000+ notices, complete from April 2023, updated within minutes of each filing.

### Overview

The Financial Datasets insider sale notices API returns the notices that company insiders file with the SEC on Form 144 when they plan to sell stock. An officer, a director, or a large shareholder files a notice when they place an order to sell more than 5,000 shares or \$50,000 of the company's stock in three months. It holds 130,000+ notices, updated within minutes of each filing. Every notice is parsed directly from SEC EDGAR ([data provenance](https://docs.financialdatasets.ai/data-provenance.md)).

You can call it as a REST endpoint with an API key, or from Claude, ChatGPT, Cursor, and other AI apps through the [MCP server](https://docs.financialdatasets.ai/mcp-server.md), or pay per request with [x402](https://docs.financialdatasets.ai/x402.md). [Pricing](https://www.financialdatasets.ai/pricing) starts at \$20.

A sale notice is early news of an insider sale. It is filed with the sell order, before the Form 4 that reports the completed trade. It complements the [insider trades API](https://docs.financialdatasets.ai/api/insider-trades.md): notices are the planned sales, trades are the completed buys and sells.

With no filter, the endpoint is a feed of the newest notices from every company. Add filters to answer questions like:

* Which insiders filed a notice to sell Apple stock this month?
* Which sale notices did one insider file this year, and under which trading plan?
* Which insiders across the market filed a notice to sell today?

To get started, please create an account and grab your **API key** at [financialdatasets.ai](https://financialdatasets.ai).

You will use the API key to authenticate your API requests.

### Coverage

| Notices | History | Updated |
| - | - | - |
| 130,000+ | Complete from April 13, 2023 | Within minutes of each filing |

Electronic filing of Form 144 became mandatory on April 13, 2023. Notices that were filed electronically before that day, from September 2022, are included too.

### Getting Started

There are only 3 steps for making a successful API call:

1. Add your API key to the header of the request as `X-API-KEY`.
2. Add query params like `ticker` and `limit` to filter the data.
3. Execute the API request.

### The Response

Each item is one notice. Numbers and text are as the seller filed them. These fields need a word:

* `ticker`: the ticker you asked for. With no `ticker` filter, it is the company's main ticker.
* `name` and `relationships`: the seller, and the seller's relationship to the company (e.g., `Officer`, `Director`), as filed.
* `form_type`: `144` for a notice, `144/A` for a corrected notice.
* `replaces_accession_number`: on a corrected notice, the accession number of the notice it replaces. The API returns the newest version of a notice only.
* `filing_date` and `notice_date`: the day the SEC received the notice, and the day the seller signed it.
* `securities`: one entry per class of stock to sell, with `shares_to_sell`, `market_value`, `shares_outstanding`, `approximate_sale_date`, `exchange`, and `broker`.
* `acquisitions`: how and when the seller got the shares, for example restricted stock units from the company. `is_gift` and `donor_acquired_date` tell you about shares the seller received as a gift.
* `sales_past_3_months`: the seller's sales of the company's stock in the three months before the notice, with `sale_date`, `shares`, and `gross_proceeds`. The `name` on a sale can be a trust or another account of the seller. The list is empty when the seller reports no sales.
* `plan_adoption_dates`: the day the seller adopted the Rule 10b5-1 trading plan that the sale falls under. The list is empty when the notice names no plan.
* `remarks`: the seller's free text. On a corrected notice it often says what changed.
* `filing_url`: the notice on SEC EDGAR.

### What a Notice Tells You

* **A planned sale, not a completed trade.** The seller files the notice with the sell order, and the sale often happens the same day. The completed trade is in the [insider trades API](https://docs.financialdatasets.ai/api/insider-trades.md).
* **The most the seller may sell.** The actual sale can be smaller, or may not happen.
* **Sales only.** There is no notice for a purchase.

### Filtering the Data

No parameter is required. With no filter, you get the newest notices first.

You can filter the data by `ticker`, `name`, and `filing_date`. All filters combine.

**Note**: by default, `limit` is `10`.

The `ticker` parameter is used to filter the notices of one company (e.g., `AAPL`). It matches the company, so the share classes of one company give the same notices: `GOOG` and `GOOGL` both return every Alphabet notice.

The `name` parameter is used to filter notices by seller. Every word you send must be in the name, in any order and any case, so `name=James Fay` finds "Fay James Daniel", and a last name alone is enough.

The `filing_date` parameter filters by the day the notice was filed, in `YYYY-MM-DD` format. For example, `filing_date_gte=2026-01-01` and `filing_date_lte=2026-06-30` give the notices filed in the first half of 2026.

The available `filing_date` operations are:

* `filing_date_lte`
* `filing_date_lt`
* `filing_date_gte`
* `filing_date_gt`
* `filing_date`

The `limit` parameter is the total number of notices to return across all pages. Each page holds up to 10 notices, linked by `next_page_url`. The maximum value is `1000`.

### Example (the feed)

```python Insider Sale Notices theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import requests

# add your API key to the headers
headers = {
    "X-API-KEY": "your_api_key_here"
}

# the newest notices from every company
url = 'https://api.financialdatasets.ai/insider-trades/sale-notices?limit=10'

# make API request
response = requests.get(url, headers=headers)

# parse sale_notices from the response
sale_notices = response.json().get('sale_notices')
```

### Example (with ticker)

```python Insider Sale Notices theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import requests

# add your API key to the headers
headers = {
    "X-API-KEY": "your_api_key_here"
}

# set your query params
ticker = 'AAPL'     # stock ticker
limit = 10          # number of notices to return

# create the URL
url = (
    f'https://api.financialdatasets.ai/insider-trades/sale-notices'
    f'?ticker={ticker}'
    f'&limit={limit}'
)

# make API request
response = requests.get(url, headers=headers)

# parse sale_notices from the response
sale_notices = response.json().get('sale_notices')
```

### Example (with name)

```python Insider Sale Notices theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import requests

# add your API key to the headers
headers = {
    "X-API-KEY": "your_api_key_here"
}

# set your query params
name = 'Parekh'     # every word must be in the seller's name

# create the URL
url = (
    f'https://api.financialdatasets.ai/insider-trades/sale-notices'
    f'?name={name}'
    f'&limit=10'
)

# make API request
response = requests.get(url, headers=headers)

# parse sale_notices from the response
sale_notices = response.json().get('sale_notices')
```

### Example (with filing\_date)

```python Insider Sale Notices theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import requests

# add your API key to the headers
headers = {
    "X-API-KEY": "your_api_key_here"
}

# set your query params
ticker = 'AAPL'
filing_date_gte = '2026-01-01' # start date
filing_date_lte = '2026-06-30' # end date

# create the URL
url = (
    f'https://api.financialdatasets.ai/insider-trades/sale-notices'
    f'?ticker={ticker}'
    f'&filing_date_gte={filing_date_gte}'
    f'&filing_date_lte={filing_date_lte}'
)

# make API request
response = requests.get(url, headers=headers)

# parse sale_notices from the response
sale_notices = response.json().get('sale_notices')
```

### Example Response

```json theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
{
  "sale_notices": [
    {
      "ticker": "AAPL",
      "issuer": "Apple Inc.",
      "name": "KEVAN PAREKH",
      "relationships": ["Officer"],
      "form_type": "144",
      "filing_date": "2026-10-16",
      "notice_date": "2026-10-16",
      "accession_number": "0001950047-26-010286",
      "replaces_accession_number": null,
      "securities": [
        {
          "security_title": "Common",
          "shares_to_sell": 1392,
          "market_value": 476064.0,
          "shares_outstanding": 14594180000,
          "approximate_sale_date": "2026-10-16",
          "exchange": "NASDAQ",
          "broker": "Morgan Stanley Smith Barney LLC Executive Financial Services"
        }
      ],
      "acquisitions": [
        {
          "security_title": "Common",
          "acquired_date": "2026-10-15",
          "nature_of_acquisition": "Restricted Stock Units",
          "acquired_from": "Issuer",
          "is_gift": false,
          "donor_acquired_date": null,
          "shares": 1392,
          "payment_date": "2026-10-15",
          "nature_of_payment": "N/A"
        }
      ],
      "sales_past_3_months": [],
      "plan_adoption_dates": ["2025-11-21"],
      "remarks": null,
      "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000195004726010286/primary_doc.xml"
    }
  ]
}
```

### FAQ

#### Where does the sale notice data come from?

Directly from SEC EDGAR. Each Form 144 and Form 144/A filing is parsed into one structured notice.

#### How fast do new notices show up?

Within minutes of each filing.

#### How is a sale notice different from an insider trade?

A sale notice (Form 144) says an insider plans to sell, and it is filed with the sell order. An insider trade (Form 4) reports a completed buy or sale, up to two business days after it happens. Use this API for the early signal and the [insider trades API](https://docs.financialdatasets.ai/api/insider-trades.md) for the completed trade.

#### What happens when a notice is corrected?

The seller files a Form 144/A. The API then returns the corrected notice in place of the notice it replaces, and `replaces_accession_number` names that notice.

#### How far back does the data go?

It is complete from April 13, 2023, and includes the notices filed electronically from September 2022.

#### Can I get a webhook for each new notice?

Yes. Subscribe to [`insider_sale_notices.created`](https://docs.financialdatasets.ai/webhooks/events).

#### Can an AI agent use this data?

Yes. Claude, ChatGPT, Cursor, and other MCP clients reach it through the [Financial Datasets MCP server](https://docs.financialdatasets.ai/mcp-server.md). An agent with a wallet can also pay per request with [x402](https://docs.financialdatasets.ai/x402.md), with no account.


## OpenAPI

````yaml GET /insider-trades/sale-notices
openapi: 3.0.1
info:
  title: Financial Datasets API
  description: >-
    Stock market API with real-time and historical financial data for 27,000+
    tickers over 30+ years. Financial statements, equity prices, insider trades,
    SEC filings, and more.
  version: 1.0.0
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  contact:
    name: API Support
    url: mailto:support@financialdatasets.ai
    email: support@financialdatasets.ai
  termsOfService: https://financialdatasets.ai/terms-of-use
servers:
  - url: https://api.financialdatasets.ai/
    description: Production server
security:
  - X-API-KEY: []
tags:
  - name: Financial Statements
    description: Access to income statements, balance sheets, and cash flow statements
  - name: Market Data
    description: Real-time and historical price data
  - name: Company Information
    description: Company facts like ticker, name, and description
  - name: Earnings
    description: Earnings data and related information
  - name: News
    description: Real-time and historical news articles
  - name: SEC Filings
    description: SEC filings and regulatory documents
  - name: Insider Trades
    description: Insider trading activity and transactions
  - name: Insider Sale Notices
    description: SEC Form 144 notices of proposed insider stock sales
  - name: Politician Trades
    description: Stock trades disclosed by members of Congress
  - name: Activist Ownership
    description: Activist stakes from SEC Schedule 13D filings, in real time
  - name: Beneficial Ownership
    description: >-
      Holders of more than 5% of a company's shares, from SEC Schedules 13D and
      13G
  - name: Insider Ownership
    description: Insider ownership statements from SEC Forms 3 and 5
  - name: Institutional Holdings
    description: SEC-direct 13F equity holdings of institutional investment managers
  - name: IPOs
    description: >-
      Upcoming IPOs from SEC registration statements (Form S-1), with extracted
      pre-IPO financial statements
  - name: Index Funds
    description: >-
      ETF and index-fund holdings, weights, and the funds that hold a given
      security
  - name: Financial Metrics
    description: Financial ratios, metrics, and key performance indicators
  - name: Macroeconomics
    description: Real-time and historical macroeconomic data like interest rates
  - name: KPIs
    description: Sector-specific operational KPIs extracted from earnings releases.
  - name: Agent Account
    description: Self-serve account creation and funding for AI agents.
  - name: Search
    description: Search financial documents with one question and get cited passages back
paths:
  /insider-trades/sale-notices:
    get:
      tags:
        - Insider Sale Notices
      summary: Get insider sale notices
      description: >-
        Get the notices that insiders file on SEC Form 144 when they plan to
        sell company stock. No parameter is required: with no filter, the newest
        notices come first.
      operationId: getInsiderSaleNotices
      parameters:
        - name: ticker
          in: query
          description: >-
            Filter by the company's stock ticker (e.g., 'AAPL'). It matches the
            company, so the share classes of one company give the same notices:
            'GOOG' and 'GOOGL' both return every Alphabet notice.
          required: false
          schema:
            type: string
        - name: name
          in: query
          description: >-
            Filter by seller name. Every word must be in the name, in any order
            and any case, so a last name alone is enough.
          required: false
          schema:
            type: string
        - name: filing_date
          in: query
          description: >-
            Filter by the date the notice was filed: equal to this date
            (YYYY-MM-DD).
          required: false
          schema:
            type: string
            format: date
        - name: filing_date_gte
          in: query
          description: >-
            Filter by the date the notice was filed: on or after this date
            (YYYY-MM-DD).
          required: false
          schema:
            type: string
            format: date
        - name: filing_date_lte
          in: query
          description: >-
            Filter by the date the notice was filed: on or before this date
            (YYYY-MM-DD).
          required: false
          schema:
            type: string
            format: date
        - name: filing_date_gt
          in: query
          description: >-
            Filter by the date the notice was filed: after this date
            (YYYY-MM-DD).
          required: false
          schema:
            type: string
            format: date
        - name: filing_date_lt
          in: query
          description: >-
            Filter by the date the notice was filed: before this date
            (YYYY-MM-DD).
          required: false
          schema:
            type: string
            format: date
        - name: limit
          in: query
          description: >-
            The maximum number of notices to return (default: 10, max: 1000).
            This is the total across all pages, not a page size: each page holds
            up to 10 records, linked by `next_page_url`.
          required: false
          schema:
            type: integer
            default: 10
        - name: cursor
          in: query
          description: >-
            Opaque pagination cursor from a previous response's next_page_url.
            When provided, all other query parameters are ignored: the cursor
            carries the original request's filters. Treat it as opaque; do not
            construct or modify it.
          required: false
          schema:
            type: string
      responses:
        '200':
          description: Insider sale notices response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InsiderSaleNoticesResponse'
        '400':
          $ref: '#/components/responses/BadRequestError'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '402':
          $ref: '#/components/responses/PaymentRequiredError'
components:
  schemas:
    InsiderSaleNoticesResponse:
      type: object
      properties:
        sale_notices:
          type: array
          items:
            $ref: '#/components/schemas/InsiderSaleNotice'
        next_page_url:
          type: string
          description: >-
            Absolute URL of the next page of results. Present only when more
            results remain; request it as-is to continue. Each page holds up to
            10 records.
    InsiderSaleNotice:
      type: object
      properties:
        ticker:
          type: string
          nullable: true
          description: >-
            The ticker you asked for. With no ticker filter, the company's main
            ticker.
        issuer:
          type: string
          nullable: true
          description: The company whose stock is to be sold, as filed.
        name:
          type: string
          nullable: true
          description: The seller's name, as filed.
        relationships:
          type: array
          items:
            type: string
          description: >-
            The seller's relationships to the company (e.g., Officer, Director),
            as filed.
        form_type:
          type: string
          enum:
            - '144'
            - 144/A
          description: 144 for a notice, 144/A for a corrected notice.
        filing_date:
          type: string
          format: date
          description: The date the SEC received the notice.
        notice_date:
          type: string
          format: date
          nullable: true
          description: The date the seller signed the notice.
        accession_number:
          type: string
          description: The SEC's unique id for this filing.
        replaces_accession_number:
          type: string
          nullable: true
          description: >-
            On a corrected notice (144/A), the accession number of the notice it
            replaces. Null on a first notice.
        securities:
          type: array
          description: One entry per class of stock to sell.
          items:
            type: object
            properties:
              security_title:
                type: string
                nullable: true
                description: The class of stock, as filed (e.g., Common).
              shares_to_sell:
                type: number
                nullable: true
                description: The number of shares the seller may sell.
              market_value:
                type: number
                nullable: true
                description: The market value of those shares, as the seller stated it.
              shares_outstanding:
                type: number
                nullable: true
                description: The company's shares outstanding, as the seller stated them.
              approximate_sale_date:
                type: string
                format: date
                nullable: true
                description: The approximate date of the sale.
              exchange:
                type: string
                nullable: true
                description: The exchange the shares are to be sold on.
              broker:
                type: string
                nullable: true
                description: The broker or market maker that handles the sale.
        acquisitions:
          type: array
          description: How and when the seller got the shares to sell.
          items:
            type: object
            properties:
              security_title:
                type: string
                nullable: true
                description: The class of stock, as filed.
              acquired_date:
                type: string
                format: date
                nullable: true
                description: The date the seller acquired the shares.
              nature_of_acquisition:
                type: string
                nullable: true
                description: >-
                  How the seller acquired the shares, as filed (e.g., Restricted
                  Stock Units).
              acquired_from:
                type: string
                nullable: true
                description: Who the seller acquired the shares from (e.g., Issuer).
              is_gift:
                type: boolean
                nullable: true
                description: True when the seller received the shares as a gift.
              donor_acquired_date:
                type: string
                format: date
                nullable: true
                description: For a gift, the date the donor acquired the shares.
              shares:
                type: number
                nullable: true
                description: The number of shares acquired.
              payment_date:
                type: string
                format: date
                nullable: true
                description: The date the seller paid for the shares.
              nature_of_payment:
                type: string
                nullable: true
                description: How the seller paid for the shares, as filed.
        sales_past_3_months:
          type: array
          description: >-
            The seller's sales of the company's stock in the three months before
            the notice. Empty when the seller reports none.
          items:
            type: object
            properties:
              name:
                type: string
                nullable: true
                description: >-
                  The seller of that sale, as filed. It can be a trust or
                  another account of the seller.
              security_title:
                type: string
                nullable: true
                description: The class of stock, as filed.
              sale_date:
                type: string
                format: date
                nullable: true
                description: The date of the sale.
              shares:
                type: number
                nullable: true
                description: The number of shares sold.
              gross_proceeds:
                type: number
                nullable: true
                description: The gross proceeds of the sale, in dollars.
        plan_adoption_dates:
          type: array
          items:
            type: string
            format: date
          description: >-
            The date the seller adopted the Rule 10b5-1 trading plan that the
            sale falls under. Empty when the notice names no plan.
        remarks:
          type: string
          nullable: true
          description: >-
            The seller's free text. On a corrected notice it often says what
            changed.
        filing_url:
          type: string
          description: The notice on SEC EDGAR.
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: A short error message.
        message:
          type: string
          description: A more detailed error message.
  responses:
    BadRequestError:
      description: Bad request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            error: Bad Request
            message: Invalid request parameters
    UnauthorizedError:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            error: Unauthorized
            message: Invalid API key provided
    PaymentRequiredError:
      description: The request requires a paid subscription
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            error: Payment Required
            message: >-
              This endpoint requires a paid subscription. Please upgrade your
              plan.
  securitySchemes:
    X-API-KEY:
      type: apiKey
      name: X-API-KEY
      description: API key for authentication.
      in: header

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.