---
title: "Fetch a Linked Account"
method: GET
path: "/v2/accounts/{account_id}"
tags: ["Linked Accounts", "Partner Accounts"]
---

# Fetch a Linked Account

`GET /v2/accounts/{account_id}`

Retrieve the details of a Linked Account by its ID. Also used in Partners API to fetch sub-merchant account details (authentication: OAuth access_token).

## Path parameters

- `account_id` string, required

## Response `200`

Linked Account details.

- LinkedAccount — A sub-merchant (Linked Account) created under a Route marketplace account. Linked Accounts can receive transfers and settlements. Prefix: acc_
  - `id` string — Account ID. Prefix: acc_
  - `type` 'route' — Account type. Always 'route' for Route marketplace accounts.
  - `status` 'created' | 'suspended' — Account status.
  - `email` string — Contact email. Cannot be updated after creation.
  - `phone` string — Contact phone number with country code (e.g., +919876543210).
  - `legal_business_name` string — Registered legal name of the business.
  - `business_type` 'route' — Business type. Cannot be updated after creation.
  - `profile` object
    - `category` string — Business category (e.g., healthcare, education, ecommerce).
    - `subcategory` string — Business subcategory.
    - `addresses` object
      - `registered` object
        - `street1` string
        - `street2` string
        - `city` string
        - `state` string
        - `postal_code` string
        - `country` string
      - `operation` object
        - `street1` string
        - `street2` string
        - `city` string
        - `state` string
        - `postal_code` string
        - `country` string
  - `legal_info` object
    - `pan` string — Business PAN number.
    - `gst` string — GST number (22 chars).
  - `contact_name` string — Name of the primary contact person.
  - `contact_info` object
    - `chargeback` object
      - `email` string
      - `phone` string
      - `policy_url` string
    - `refund` object
      - `email` string
      - `phone` string
      - `policy_url` string
    - `support` object
      - `email` string
      - `phone` string
      - `policy_url` string
  - `apps` object
    - `websites` string[]
    - `android` object[]
      - `url` string
      - `name` string
    - `ios` object[]
      - `url` string
      - `name` string
  - `notes` Notes — Key-value pairs for storing custom metadata. Maximum 15 pairs. Each key and value must not exceed 256 characters.
  - `created_at` integer

## Other responses

- `401` — Authentication failed. Invalid or missing API key credentials.
- `404` — Resource not found.
- `429` — Rate limit exceeded. Implement exponential backoff with jitter before retrying.

---

[API](https://skmtc.net/razorpay/apis/razorpay-api.md) · [All operations](https://skmtc.net/razorpay/apis/razorpay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/razorpay/razorpay-api/versions/824ca9e6faef/schema)