Version: 1.0.2

Add Legal Representative

'AddLegalRep' API enables to add legal representative to the business customer account

Bank or financial institution can add legal representative to the business customer account for managing and operating the account. On providing the request with legal representative details and the specific account number to which to be added, the legal representative is added to the business customer account with the generation of unique legalrep ID.

Method: POST

{{URL}}/jsonrpc
Headers

Name	Value
Content-Type	application/json

Example

Payload Parameters

Parameter	Description
method Mandatory	String API method that is being called to add new Legal Representative through customer service Constant value: "CustomerService.AddLegalRep"
id Mandatory	String Unique ID of API request Sample value: "1"
params Mandatory	Object
api Mandatory	Object
signature Mandatory	String Signature for request validation Sample value: "signature code"
keyId Mandatory	String API key used for request authentication Sample value: "ApplicationKeyId"
credential Mandatory	String API credential provided by NetXD Sample value: "Credential"
payload Mandatory	Object
name Mandatory	String Name of the legalRep to be added Sample value: "Ahmed"
AccountNumber Optional	String Account number to which the legal representative is connected Sample value: "200323560055294"
userFlags Optional	Object
authorizeTransaction Optional	Boolean Enabling or disabling the option of authorizing the transaction initiated by another legal representative Sample value: true
selfAuthorizeTransaction Optional	Boolean Enabling or disabling the option of authorizing self-initiated transaction Sample value: true
canInitiateTransfer Optional	Boolean Enabling or disabling the option of initiating transaction Sample value: true
canApproveNewRoute Optional	Boolean Enabling or disabling the legal representative to allow approval option for added beneficiary Sample value: true
emailNotification Optional	Boolean Enabling or disabling email notification to the legal representative Sample value: true
isSignatory Optional	Boolean Enabling or disabling the legal representative to be a signing authority Sample value: true
DOB Mandatory	String Date of birth of the legalRep to be added Sample value: "19901107"
DateOfEstablishment Optional	String Date of Establishment (in YYYYMMDD format) of organisation for which the legalRep is added Sample value: "20200710"
identification Mandatory	Object
type Mandatory	String Type of identification provided for the Legal Rep Constant value: "SSN"
value Mandatory	String Value of identification type Sample value: "766262285"
address Mandatory	Object
addressLine1 Mandatory	String FIrst Line of Legal Rep address Sample value: "2261 Market Street #4000"
city Mandatory	String City of the legalrep address Sample value: "dallas"
state Mandatory	String State of the legalrep address Sample value: "tn"
country Mandatory	String Country code of the legalrep address Sample value: "US"
zip Mandatory	String ZIP code of the legalrep address Sample value: "34354"
contact Mandatory	Object
email Mandatory	String Contact email address of Legal Rep to be added Sample value: "ahmed@NetXD.com"
phoneNumber Mandatory	String Contact phone number of Legal Rep to be added Sample value: "7668622678"
notes Optional	String Notes for reference on adding the Legal Rep Sample value: "Legal user"
InstitutionName Optional	String Name of the organisation for which the legalrep is added Sample value: "samplecustomerins"

Parameter

Description

method

Mandatory

String

API method that is being called to add new Legal Representative through customer service

Constant value: "CustomerService.AddLegalRep"

Mandatory

String

Unique ID of API request

Sample value: "1"

params

Mandatory

Object

api

Mandatory

Object

signature

Mandatory

String

Signature for request validation

Sample value: "signature code"

keyId

Mandatory

String

API key used for request authentication

Sample value: "ApplicationKeyId"

credential

Mandatory

String

API credential provided by NetXD

Sample value: "Credential"

payload

Mandatory

Object

name

Mandatory

String

Name of the legalRep to be added

Sample value: "Ahmed"

AccountNumber

Optional

String

Account number to which the legal representative is connected

Sample value: "200323560055294"

userFlags

Optional

Object

authorizeTransaction

Optional

Boolean

Enabling or disabling the option of authorizing the transaction initiated by another legal representative

Sample value: true

selfAuthorizeTransaction

Optional

Boolean

Enabling or disabling the option of authorizing self-initiated transaction

Sample value: true

canInitiateTransfer

Optional

Boolean

Enabling or disabling the option of initiating transaction

Sample value: true

canApproveNewRoute

Optional

Boolean

Enabling or disabling the legal representative to allow approval option for added beneficiary

Sample value: true

emailNotification

Optional

Boolean

Enabling or disabling email notification to the legal representative

Sample value: true

isSignatory

Optional

Boolean

Enabling or disabling the legal representative to be a signing authority

Sample value: true

DOB

Mandatory

String

Date of birth of the legalRep to be added

Sample value: "19901107"

DateOfEstablishment

Optional

String

Date of Establishment (in YYYYMMDD format) of organisation for which the legalRep is added

Sample value: "20200710"

identification

Mandatory

Object

type

Mandatory

String

Type of identification provided for the Legal Rep

Constant value: "SSN"

value

Mandatory

String

Value of identification type

Sample value: "766262285"

address

Mandatory

Object

addressLine1

Mandatory

String

FIrst Line of Legal Rep address

Sample value: "2261 Market Street #4000"

city

Mandatory

String

City of the legalrep address

Sample value: "dallas"

state

Mandatory

String

State of the legalrep address

Sample value: "tn"

country

Mandatory

String

Country code of the legalrep address

Sample value: "US"

zip

Mandatory

String

ZIP code of the legalrep address

Sample value: "34354"

contact

Mandatory

Object

Mandatory

String

Contact email address of Legal Rep to be added

Sample value: "ahmed@NetXD.com"

phoneNumber

Mandatory

String

Contact phone number of Legal Rep to be added

Sample value: "7668622678"

notes

Optional

String

Notes for reference on adding the Legal Rep

Sample value: "Legal user"

InstitutionName

Optional

String

Name of the organisation for which the legalrep is added

Sample value: "samplecustomerins"

cURL
C#
Go
NodeJS

curl --location --globoff '{{URL}}/jsonrpc' \
--header 'Content-Type: application/json' \
--data-raw '{"method":"CustomerService.AddLegalRep","id":"1","params":{"api":{"signature":"{{signature}}","keyId":"{{ApplicationKeyId}}","credential":"{{Credential}}"},"payload":{"Name":"Ahmed","AccountNumber":"200323560055294","UserFlags":{"AuthorizeTransaction":true,"SelfAuthorizeTransaction":true,"CanInitiateTransfer":true,"CanApproveNewRoute":true,"EmailNotification":true,"IsSignatory":true},"DOB":"19901107","DateOfEstablishment":"20200215","Identification":{"Type":"SSN","Value":"766262285"},"Address":{"addressLine1":"2261 Market Street #4000","city":"dallas","state":"tn","country":"US","zip":"34355"},"contact":{"email":"ahmed@NetXD.com","PhoneNumber":"7668622678"},"Notes":"Legal user","InstitutionName":"samplecustomerins"}}}'

var options = new RestClientOptions("{{URL}}/jsonrpc")
{
  MaxTimeout = -1,
};
var client = new RestClient(options);
var request = new RestRequest("", Method.Post);
request.AddHeader("Content-Type", "application/json");
var body = @"{
" + "\n" +
@"    ""method"": ""CustomerService.AddLegalRep"",
" + "\n" +
@"    ""id"": ""1"",
" + "\n" +
@"    ""params"": {
" + "\n" +
@"        ""api"": {
" + "\n" +
@"            ""signature"": ""{{signature}}"",
" + "\n" +
@"            ""keyId"": ""{{ApplicationKeyId}}"",
" + "\n" +
@"            ""credential"": ""{{Credential}}""
" + "\n" +
@"        },
" + "\n" +
@"        ""payload"": {
" + "\n" +
@"            ""Name"": ""Ahmed"",
" + "\n" +
@"            ""AccountNumber"": ""200323560055294"",
" + "\n" +
@"            ""UserFlags"": {
" + "\n" +
@"                ""AuthorizeTransaction"": true,
" + "\n" +
@"                ""SelfAuthorizeTransaction"": true,
" + "\n" +
@"                ""CanInitiateTransfer"": true,
" + "\n" +
@"                ""CanApproveNewRoute"": true,
" + "\n" +
@"                ""EmailNotification"": true,
" + "\n" +
@"                ""IsSignatory"": true
" + "\n" +
@"            },
" + "\n" +
@"            ""DOB"": ""19901107"",
" + "\n" +
@"            ""DateOfEstablishment"": ""20200215"",
" + "\n" +
@"            ""Identification"": {
" + "\n" +
@"                ""Type"": ""SSN"",
" + "\n" +
@"                ""Value"": ""766262285""
" + "\n" +
@"            },
" + "\n" +
@"            ""Address"": {
" + "\n" +
@"                ""addressLine1"": ""2261 Market Street #4000"",
" + "\n" +
@"                ""city"": ""dallas"",
" + "\n" +
@"                ""state"": ""tn"",
" + "\n" +
@"                ""country"": ""US"",
" + "\n" +
@"                ""zip"": ""34355""
" + "\n" +
@"            },
" + "\n" +
@"            ""contact"": {
" + "\n" +
@"                ""email"": ""ahmed@NetXD.com"",
" + "\n" +
@"                ""PhoneNumber"": ""7668622678""
" + "\n" +
@"            },
" + "\n" +
@"            ""Notes"": ""Legal user"",
" + "\n" +
@"            ""InstitutionName"": ""samplecustomerins""
" + "\n" +
@"        }
" + "\n" +
@"    }
" + "\n" +
@"}";
request.AddStringBody(body, DataFormat.Json);
RestResponse response = await client.ExecuteAsync(request);
Console.WriteLine(response.Content);

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "{{URL}}/jsonrpc"
  method := "POST"

  payload := strings.NewReader(`{`+"
"+`
    "method": "CustomerService.AddLegalRep",`+"
"+`
    "id": "1",`+"
"+`
    "params": {`+"
"+`
        "api": {`+"
"+`
            "signature": "{{signature}}",`+"
"+`
            "keyId": "{{ApplicationKeyId}}",`+"
"+`
            "credential": "{{Credential}}"`+"
"+`
        },`+"
"+`
        "payload": {`+"
"+`
            "Name": "Ahmed",`+"
"+`
            "AccountNumber": "200323560055294",`+"
"+`
            "UserFlags": {`+"
"+`
                "AuthorizeTransaction": true,`+"
"+`
                "SelfAuthorizeTransaction": true,`+"
"+`
                "CanInitiateTransfer": true,`+"
"+`
                "CanApproveNewRoute": true,`+"
"+`
                "EmailNotification": true,`+"
"+`
                "IsSignatory": true`+"
"+`
            },`+"
"+`
            "DOB": "19901107",`+"
"+`
            "DateOfEstablishment": "20200215",`+"
"+`
            "Identification": {`+"
"+`
                "Type": "SSN",`+"
"+`
                "Value": "766262285"`+"
"+`
            },`+"
"+`
            "Address": {`+"
"+`
                "addressLine1": "2261 Market Street #4000",`+"
"+`
                "city": "dallas",`+"
"+`
                "state": "tn",`+"
"+`
                "country": "US",`+"
"+`
                "zip": "34355"`+"
"+`
            },`+"
"+`
            "contact": {`+"
"+`
                "email": "ahmed@NetXD.com",`+"
"+`
                "PhoneNumber": "7668622678"`+"
"+`
            },`+"
"+`
            "Notes": "Legal user",`+"
"+`
            "InstitutionName": "samplecustomerins"`+"
"+`
        }`+"
"+`
    }`+"
"+`
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Content-Type", "application/json")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

var https = require('follow-redirects').https;
var fs = require('fs');

var options = {
  'method': 'POST',
  'hostname': '{{URL}}',
  'path': '/jsonrpc',
  'headers': {
    'Content-Type': 'application/json'
  },
  'maxRedirects': 20
};

var req = https.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function (chunk) {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });

  res.on("error", function (error) {
    console.error(error);
  });
});

var postData = JSON.stringify({
  "method": "CustomerService.AddLegalRep",
  "id": "1",
  "params": {
    "api": {
      "signature": "{{signature}}",
      "keyId": "{{ApplicationKeyId}}",
      "credential": "{{Credential}}"
    },
    "payload": {
      "Name": "Ahmed",
      "AccountNumber": "200323560055294",
      "UserFlags": {
        "AuthorizeTransaction": true,
        "SelfAuthorizeTransaction": true,
        "CanInitiateTransfer": true,
        "CanApproveNewRoute": true,
        "EmailNotification": true,
        "IsSignatory": true
      },
      "DOB": "19901107",
      "DateOfEstablishment": "20200215",
      "Identification": {
        "Type": "SSN",
        "Value": "766262285"
      },
      "Address": {
        "addressLine1": "2261 Market Street #4000",
        "city": "dallas",
        "state": "tn",
        "country": "US",
        "zip": "34355"
      },
      "contact": {
        "email": "ahmed@NetXD.com",
        "PhoneNumber": "7668622678"
      },
      "Notes": "Legal user",
      "InstitutionName": "samplecustomerins"
    }
  }
});

req.write(postData);

req.end();

Body

{
  "method": "CustomerService.AddLegalRep",
  "id": "1",
  "params": {
    "api": {
      "signature": "{{signature}}",
      "keyId": "{{ApplicationKeyId}}",
      "credential": "{{Credential}}"
    },
    "payload": {
      "Name": "Ahmed",
      "AccountNumber": "200323560055294",
      "UserFlags": {
        "AuthorizeTransaction": true,
        "SelfAuthorizeTransaction": true,
        "CanInitiateTransfer": true,
        "CanApproveNewRoute": true,
        "EmailNotification": true,
        "IsSignatory": true
      },
      "DOB": "19901107",
      "DateOfEstablishment": "20200215",
      "Identification": {
        "Type": "SSN",
        "Value": "766262285"
      },
      "Address": {
        "addressLine1": "2261 Market Street #4000",
        "city": "dallas",
        "state": "tn",
        "country": "US",
        "zip": "34355"
      },
      "contact": {
        "email": "ahmed@NetXD.com",
        "PhoneNumber": "7668622678"
      },
      "Notes": "Legal user",
      "InstitutionName": "samplecustomerins"
    }
  }
}

Response: 200

Response Parameters

Parameter	Description
id	String Response ID echoed from the request ID Sample value: "1"
result	Object
Id	String Unique system generated ID for the newly added Legal Rep Sample value: "42342"
Name	String Name of the legalrep who was added Sample value: "John deo"
Key	String Key ID associated with the information and account details of of the newly added legalrep Sample value: "LREP231201913406"
DOB	String Date of birth of the legalRep who is added newly Sample value: "19901107"
DateOfEstablishment	String Date of Establishment (in YYYYMMDD format) of organisation for which the legalRep is added Sample value: "20200215"
identification Mandatory	Object
type Mandatory	String Type of identification provided for the Legal Rep Constant value: "SSN"
value Mandatory	String Value of identification type Sample value: "766262285"
SsnTaxOtherId	String Other tax and identity verification IDs, if available Sample value: "XX709531"
address Optional	Object
addressLine1 Optional	String First line of Legal Rep Address Sample value: "2261 Market Street #4000"
city Optional	String City of the legalrep address Sample value: "dallas"
state Optional	String State of the legalrep address Sample value: "tn"
country Optional	String Country code of the legalrep address Sample value: "US"
zip Optional	String ZIP code of the legalrep address Sample value: "34354"
contact Optional	Object
email Optional	String Contact email address of Legal Rep Sample value: "ahmed@NetXD.com"
phoneNumber Optional	String Contact phone number of Legal Rep Address Sample value: "7668622678"
InstitutionName Optional	String Name of the organisation for which the legalrep is added Sample value: "samplecustomerins"

Parameter

Description

String

Response ID echoed from the request ID

Sample value: "1"

result

Object

String

Unique system generated ID for the newly added Legal Rep

Sample value: "42342"

Name

String

Name of the legalrep who was added

Sample value: "John deo"

Key

String

Key ID associated with the information and account details of of the newly added legalrep

Sample value: "LREP231201913406"

DOB

String

Date of birth of the legalRep who is added newly

Sample value: "19901107"

DateOfEstablishment

String

Date of Establishment (in YYYYMMDD format) of organisation for which the legalRep is added

Sample value: "20200215"

identification

Mandatory

Object

type

Mandatory

String

Type of identification provided for the Legal Rep

Constant value: "SSN"

value

Mandatory

String

Value of identification type

Sample value: "766262285"

SsnTaxOtherId

String

Other tax and identity verification IDs, if available

Sample value: "XX709531"

address

Optional

Object

addressLine1

Optional

String

First line of Legal Rep Address

Sample value: "2261 Market Street #4000"

city

Optional

String

City of the legalrep address

Sample value: "dallas"

state

Optional

String

State of the legalrep address

Sample value: "tn"

country

Optional

String

Country code of the legalrep address

Sample value: "US"

zip

Optional

String

ZIP code of the legalrep address

Sample value: "34354"

contact

Optional

Object

Optional

String

Contact email address of Legal Rep

Sample value: "ahmed@NetXD.com"

phoneNumber

Optional

String

Contact phone number of Legal Rep Address

Sample value: "7668622678"

InstitutionName

Optional

String

Name of the organisation for which the legalrep is added

Sample value: "samplecustomerins"

{
  "id": "1",
  "result": {
    "Id": "42342",
    "Name": "John deo",
    "Key": "LREP231201913406",
    "DOB": "19901107",
    "DateOfEstablishment": "20200215",
    "Identification": {
      "Type": "SSN",
      "Value": "766262285"
    },
    "SsnTaxOtherId": "XX709531",
    "Address": {
      "AddressLine1": "2261 Market Street #4000",
      "City": "dallas",
      "State": "tn",
      "Country": "US",
      "Zip": "34355"
    },
    "Contact": {
      "Email": "ahmed@NetXD.com",
      "PhoneNumber": "7668622678"
    },
    "InstitutionName": "samplecustomerins"
  }
}

Add Legal Representative

Method: POST​

Headers​

Example​

Body​

Response: 200​

Method: POST

Headers

Example

Body

Response: 200