---
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`

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.net/curlec/apis/razorpay-api.md) · [All operations](https://skmtc.net/curlec/apis/razorpay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/curlec/razorpay-api/revisions/824ca9e6faef/schema)