Flock API

India + US disclosure data, as an API.

Normalised regulatory disclosures — entities, holdings, filings, announcements, and multi-entity disclosure overlap — as structured JSON across 12 read endpoints, with signed webhooks. Build research tools on the same data that powers Flock.

Talk to us for a key

200 OK

GET /v1/disclosures

{
  "items": [
    {
      "id": "f3a9...",
      "entityId": "e1b2...",
      "securityId": "s7c4...",
      "action": "acquired",
      "qty": 250000,
      "filedAt": "2026-05-28T09:14:00Z",
      "sourceType": "nse_bulk",
      "sourceUrl": "https://nseindia.com/...",
      "confidence": 0.98
    }
  ],
  "nextCursor": "eyJpZCI6...",
  "total": 1
}

Definition

The Flock Business API serves Indian disclosure data over HTTP: bulk and block deals from NSE and BSE, SEBI insider and SAST filings, named holders above 1% from published shareholding patterns, AMFI scheme portfolios and US 13F holdings. 12 read endpoints, API-key authentication, an OpenAPI 3.1 specification, and signed webhook push on four event types.

Aggregate quarterly promoter / FII / DII / mutual-fund percentages are held and power the web product, but are not a v1 endpoint. Ask us.

Read endpoints: 12
Webhook event types: 4
Typed clients, generated: OpenAPI 3.1
Registers in the corpus: 9

Endpoint and register counts as of 20 August 2026.

What's in the API

Entities: canonical investors, funds, FIIs, and 13F filers, with resolved aliases
Disclosures: every ingested filing, time-stamped and source-linked
Holdings: reported holdings per entity
Announcements: corporate announcements per security, filterable by category, with the exchange's own subject string kept in rawCategory
Convergence: multi-entity disclosure overlap as a query primitive — surfaced in the product as Smart Money Overlap
Webhooks: disclosure.created, announcement.created, convergence.created, convergence.updated — the four types registration accepts
Test keys: sk_test_* keys read the same live data as sk_live_* — they are for wiring up an integration, not a fixture dataset
OpenAPI 3.1 spec: generate a typed client in your language instead of writing one

The endpoints

Full request/response shapes in the OpenAPI spec.

GET /v1/entities
Resolved entities — investors, funds, FIIs and 13F filers — cursor-paginated.
GET /v1/entities/:id
One entity, with aliases collapsed onto a single identity.
GET /v1/entities/:id/disclosures
Every disclosure filed by one entity, cursor-paginated.
GET /v1/entities/:id/holdings
Reported holdings for one entity, as disclosed in public filings.
GET /v1/securities
Securities across India and the US, searchable by name or ticker.
GET /v1/securities/:id
One security, with its ISIN and NSE / BSE tickers.
GET /v1/securities/:id/disclosures
Every disclosure that names one security, cursor-paginated.
GET /v1/securities/:id/holders
Entities that have disclosed holdings in one security.
GET /v1/securities/:id/announcements
Corporate announcements for one security, cursor-paginated.
category-filterable
GET /v1/securities/:id/events
Upcoming exchange calendar dates for one security — board meetings for results, dividends and fund raising.
not paginated
GET /v1/convergence
Multi-entity disclosure overlap as a query primitive — surfaced in the product as Smart Money Overlap.
GET /v1/convergence/:id
One overlap event: the entity count, the window, and the security involved.

Frequently asked questions

Is there an API for Indian shareholding and bulk deal data?

Yes. Flock's read API serves NSE and BSE bulk and block deals, SEBI insider filings (PIT Regulation 7), SAST stake and pledge filings, and named holders above 1% from published shareholding patterns. Aggregate quarterly promoter, FII and DII percentages are held in the corpus but are not a v1 endpoint yet; ask us.

Does it cover US 13F filings as well as Indian filings?

Yes. SEC 13F holdings from the information table sit in the same API, with the same resolved entity identity as the Indian filings, so one filer is one entity across both markets. A 13F reports quarter-end positions and can be filed up to 45 days later; every row carries its filing date.

How fresh is each feed?

Cadence is per feed, not a blanket real-time claim: bulk and block deals every 30 minutes through the trading day plus an end-of-day pass; corporate announcements every 30 minutes around the clock; insider and SAST filings daily; 13F and AMFI checked daily against sources that are quarterly and monthly by nature.

How do I get an API key, and what does it cost?

The Business plan is ₹39,999 per month for 100,000 API requests across all read endpoints, with webhook deliveries outside the read quota. A person issues your key the same day the plan is active; there is no self-serve issuance. Test keys read the same live data. No free trial.

Coverage, pricing and redistribution

What is in the data register by register, how often each feed updates, the plan price, and what you may send on to your own clients — all on one page, with a form that reaches a person.

Flock for business

Build against live data.

A test key reads the same live registers as a live key, so your integration tests assert on real filings. A person issues it the same day your plan is active, and stays reachable afterwards.

Talk to us for a key See full pricing