---
title: "Promoter pledge by quarter"
method: GET
path: "/v1/stocks/{symbol}/promoter-pledge"
tags: ["ownership"]
---

# Promoter pledge by quarter

`GET /v1/stocks/{symbol}/promoter-pledge`

## Request

- Base URL: `https://api.tapetide.com`
- URL: `https://api.tapetide.com/v1/stocks/{symbol}/promoter-pledge`
- Auth: HTTP bearer

Quarterly disclosure of promoter shares pledged, with the pledged share of the promoter holding and of all shares. Broad coverage starts with the March 2026 quarter (a handful of companies from 2012). Oldest quarter first by default (`order=desc` for newest first). Updated as companies file.

## Path parameters

- `symbol` string, required: Stock symbol, e.g. "RELIANCE". Percent-encode "&" (M%26M).

## Query parameters

- `order` 'asc' | 'desc'
- `limit` integer
- `cursor` string

## Response `200`

OK. Costs one request unit.

- object
  - `data` StockPromoterPledgeItem[], required
    - `symbol` string, required: Stock symbol.
    - `quarter_end` string, required: Quarter-end date of the pledge disclosure (YYYY-MM-DD).
    - `disclosed_at` string, nullable, required: When the quarterly pledge data was published (ISO-8601 UTC).
    - `total_shares` number, nullable, required: Total issued shares.
    - `promoter_shares` number, nullable, required: Shares held by the promoter group.
    - `promoter_holding_pct` number, nullable, required: Promoter-group holding, % of total shares.
    - `promoter_shares_pledged` number, nullable, required: Promoter-group shares pledged.
    - `promoter_pledged_pct` number, nullable, required: Promoter shares pledged, % of the promoter group's own holding. The usual governance red-flag measure.
    - `total_shares_pledged` number, nullable, required: All pledged shares in the depository (promoter and non-promoter).
    - `total_pledged_pct` number, nullable, required: All pledged shares, % of dematerialised shares.
  - `meta` ListMeta, required
    - `as_of` string, date-time, required: When this response was assembled (UTC).
    - `route` string, required: operationId that served the request.
    - `count` integer, required: Items in this page.
    - `limit` integer, required: Page size applied.
    - `has_more` boolean, required: Whether another page exists.
    - `next_cursor` string, nullable, required: Pass as `cursor` to fetch the next page; null on the last page.
  - `links` Links, required
    - `next` string, nullable: Relative URL of the next page, or null.

## Other responses

- `400`: Malformed or out-of-range parameter. Not charged.
- `401`: Missing or invalid bearer token.
- `404`: The requested resource does not exist. Not charged.
- `429`: Per-minute burst cap (`rate_limited`) or plan quota (`quota_exhausted`) reached.
- `500`: Unexpected server error. Not charged.
- `502`: A data dependency was unavailable. Not charged.
- `503`: Authentication or quota service temporarily unavailable (`service_unavailable`). Not charged; retry after `Retry-After` seconds.

---

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