/accounts/relationship/{parentAccountId}/{childAccountId}

GET /accounts/relationship/{parentAccountId}/{childAccountId}

Get a specific parent-child relationship

Retrieve details of a specific relationship between two accounts. Requires Super Admin permissions.

Authentication Required

Authorization: Bearer {token} header string

This header is required to access this endpoint

Required Parameters

parentAccountId path string

Unique ID of the parent account

childAccountId path string

Unique ID of the child account

Try it out

Output:

Responses

Description

Successful response

{
  "parentAccountId": "string",
  "childAccountId": "string",
  "createdBy": "string",
  "createdAt": "string",
  "parentAccount": {
    "uniqueId": "string",
    "name": "string",
    "accountTypeId": "string",
    "repcode": "string"
  },
  "childAccount": {
    "uniqueId": "string",
    "name": "string",
    "accountTypeId": "string",
    "repcode": "string"
  }
}

References

#/components/schemas/AccountSummary #/components/schemas/AccountRelationship

type: object
properties:
  uniqueId:
    type: string
    description: Unique identifier for the account
  name:
    type: string
    description: Account name
  accountTypeId:
    type: string
    nullable: true
    description: Type of account (e.g., "iso", "agent", "merchant")
  repcode:
    type: string
    nullable: true
    description: Representative code for the account
required:
  - uniqueId
  - name

|
export interface AccountSummary {
  /** Unique identifier for the account */
  uniqueId: string;
  /** Account name */
  name: string;
  /** Type of account (e.g., "iso", "agent", "merchant") */
  accountTypeId?: string;
  /** Representative code for the account */
  repcode?: string;
}

#/components/schemas/AccountRelationship

OpenAPI
TypeScript

type: object
properties:
  parentAccountId:
    type: string
    description: Unique ID of the parent account
  childAccountId:
    type: string
    description: Unique ID of the child account
  createdBy:
    type: string
    description: Email of the user who created the relationship
  createdAt:
    type: string
    format: date-time
    description: Timestamp when the relationship was created
  parentAccount:
    $ref: "#/components/schemas/AccountSummary"
  childAccount:
    $ref: "#/components/schemas/AccountSummary"
required:
  - parentAccountId
  - childAccountId
  - createdBy
  - createdAt

|
export interface AccountRelationship {
  /** Unique ID of the parent account */
  parentAccountId: string;
  /** Unique ID of the child account */
  childAccountId: string;
  /** Email of the user who created the relationship */
  createdBy: string;
  /** Timestamp when the relationship was created */
  createdAt: Date;
  parentAccount?: AccountSummary;
  childAccount?: AccountSummary;
}

Route Source Code

Check out the source code for this route entrypoint here: /accounts/relationship/[parentAccountId]/[childAccountId]/route.ts

Or the swagger.yaml spec this documentation was generated from: /accounts/swagger.yaml