---
title: "Get Relationship"
method: GET
path: "/v2/relationships/{id}"
tags: ["Relationships"]
---

# Get Relationship

`GET /v2/relationships/{id}`

## Request

- Base URL: `https://api.paymongo.com`
- URL: `https://api.paymongo.com/v2/relationships/{id}`
- Auth: HTTP basic

Retrieve a relationship by ID. The response includes basic details of the parent
and child accounts, not just their IDs.
Only the parent account or the child account of the relationship can access it.

## Path parameters

- `id` string, required

## Response `200`

Relationship retrieved successfully

- RelationshipResponse
  - `data` Relationship
    - `id` string: Unique identifier for the relationship. Prefixed with mr_
    - `parent_account_id` string: ID of the parent account in the relationship
    - `child_account_id` string: ID of the child account in the relationship
    - `enabled` boolean: Whether the relationship is enabled. Distinct from each account's own enabled flag
    - `linking_request_id` string, nullable: ID of the linking request that established the relationship. Prefixed with lr_. Null for relationships without an originating linking request
    - `policies` Policies, nullable: Permissions granted on the relationship, as resource to operation to grant. Null when nothing was granted. A full-access relationship carries the single grant "*": {"*": {...}}.
    - `parent_account` RelationshipAccount: Basic details of an account on one side of a relationship
      - `id` string: Unique identifier for the account. Prefixed with org_
      - `account_type` 'merchant' | 'consumer': The type of account
      - `activation_status` 'pending' | 'under_review' | 'activated' | 'declined': The current activation status of the account
      - `enabled` boolean: Whether the account itself is enabled. Distinct from the relationship's enabled flag
      - `trade_name` string: The account's trade name
      - `legal_name` string: The account's legal name
      - `business_type` string: The business entity type (e.g., individual, sole_proprietor, corporation)
    - `child_account` RelationshipAccount: Basic details of an account on one side of a relationship
      - `id` string: Unique identifier for the account. Prefixed with org_
      - `account_type` 'merchant' | 'consumer': The type of account
      - `activation_status` 'pending' | 'under_review' | 'activated' | 'declined': The current activation status of the account
      - `enabled` boolean: Whether the account itself is enabled. Distinct from the relationship's enabled flag
      - `trade_name` string: The account's trade name
      - `legal_name` string: The account's legal name
      - `business_type` string: The business entity type (e.g., individual, sole_proprietor, corporation)
    - `created_at` integer: Unix timestamp indicating when the relationship was created
    - `updated_at` integer: Unix timestamp indicating when the relationship was last updated

## Other responses

- `401`: Unauthorized
- `403`: Forbidden - not authorized to access this relationship
- `404`: Relationship not found
- `500`: Internal server error

---

[API](https://skmtc.dev/paymongo/apis/accounts-api.md) - [All operations](https://skmtc.dev/paymongo/apis/accounts-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paymongo/apis/accounts-api/revisions/68d0b0b08710?raw)
