---
title: "Fetch all stakeholders for an account"
method: GET
path: "/v2/accounts/{account_id}/stakeholders"
tags: ["Partner Stakeholders"]
---

# Fetch all stakeholders for an account

`GET /v2/accounts/{account_id}/stakeholders`

## Request

- Base URL: `https://api.razorpay.com/v1`
- URL: `https://api.razorpay.com/v1/v2/accounts/{account_id}/stakeholders`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/razorpay/apis/razorpay-api/docs/v2/accounts/:account_id/stakeholders/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve all stakeholders associated with a sub-merchant account. Partners API only — Route allows only 1 stakeholder per account. Authentication: OAuth access_token.

## Path parameters

- `account_id` string, required

## Response `200`

List of stakeholders

- object
  - `entity` string
  - `count` integer
  - `items` PartnerStakeholder[]
    - `id` string: Stakeholder ID with prefix sth_
    - `entity` 'stakeholder'
    - `name` string
    - `email` string
    - `percentage_ownership` number
    - `relationship` object
      - `director` boolean
      - `executive` boolean
    - `phone` object
      - `primary` string
      - `secondary` string
    - `addresses` object
      - `residential` object
        - `street` string
        - `city` string
        - `state` string
        - `postal_code` string
        - `country` string
    - `kyc` object
      - `pan` string
    - `notes` object

## Other responses

- `400`: Bad request. Invalid parameters or missing required fields.
- `401`: Authentication failed. Invalid or missing API key credentials.
- `404`: Resource not found.
- `429`: Rate limit exceeded. Implement exponential backoff with jitter before retrying.
- `500`: Internal server error.

---

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