POST api/ESB/IndemnityForm

Request Information

URI Parameters

None.

Body Parameters

IndemnityRequest
NameDescriptionTypeAdditional information
Header

ESBHeaderAdvance

None.

Individual

IndemnityIndividual

None.

Organisation

IndemnityOrganisation

None.

CIFNumber

string

None.

Signers

Collection of Signer

None.

Request Formats

application/json, text/json

Sample:
{
  "Header": {
    "TransactionID": "sample string 1",
    "Organisation": "sample string 2",
    "UserID": "sample string 3",
    "SystemID": "sample string 4",
    "Timestamp": "2025-12-10T01:37:32",
    "portfolioSettings": {
      "ReferenceNumber": "sample string 1",
      "OrderNumber": 2,
      "Type": "sample string 3",
      "PortfolioCount": 4,
      "SendEmail": true,
      "PackageEmailName": "sample string 6",
      "SendOnComplete": true,
      "EmailInformationURL": "sample string 8"
    },
    "TypeOfTransaction": "sample string 6"
  },
  "Individual": {
    "FirstName": "sample string 1",
    "LastName": "sample string 2",
    "IDNumber": "sample string 3",
    "DisplayName": "sample string 4"
  },
  "Organisation": {
    "RegistrationNumber": "sample string 1",
    "BusinessName": "sample string 2"
  },
  "CIFNumber": "sample string 1",
  "Signers": [
    {
      "RSAResident": true,
      "OnBehalfOf": "sample string 2",
      "Capacity": "sample string 3",
      "Surname": "sample string 4",
      "Name": "sample string 5",
      "IdentityNo": "sample string 6",
      "MobileNumber": "sample string 7",
      "Email": "sample string 8",
      "SignerType": "sample string 9"
    },
    {
      "RSAResident": true,
      "OnBehalfOf": "sample string 2",
      "Capacity": "sample string 3",
      "Surname": "sample string 4",
      "Name": "sample string 5",
      "IdentityNo": "sample string 6",
      "MobileNumber": "sample string 7",
      "Email": "sample string 8",
      "SignerType": "sample string 9"
    }
  ]
}

application/xml, text/xml

Sample:
<IndemnityRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/MercantileEventHandler.ViewModels.ESB">
  <CIFNumber>sample string 1</CIFNumber>
  <Header>
    <Organisation>sample string 2</Organisation>
    <SystemID>sample string 4</SystemID>
    <Timestamp>2025-12-10T01:37:32.418257+00:00</Timestamp>
    <TransactionID>sample string 1</TransactionID>
    <TypeOfTransaction>sample string 6</TypeOfTransaction>
    <UserID>sample string 3</UserID>
    <portfolioSettings xmlns:d3p1="http://schemas.datacontract.org/2004/07/MercantileEventHandler.Core.API.KYC">
      <d3p1:EmailInformationURL>sample string 8</d3p1:EmailInformationURL>
      <d3p1:OrderNumber>2</d3p1:OrderNumber>
      <d3p1:PackageEmailName>sample string 6</d3p1:PackageEmailName>
      <d3p1:PortfolioCount>4</d3p1:PortfolioCount>
      <d3p1:ReferenceNumber>sample string 1</d3p1:ReferenceNumber>
      <d3p1:SendEmail>true</d3p1:SendEmail>
      <d3p1:SendOnComplete>true</d3p1:SendOnComplete>
      <d3p1:Type>sample string 3</d3p1:Type>
    </portfolioSettings>
  </Header>
  <Individual>
    <DisplayName>sample string 4</DisplayName>
    <FirstName>sample string 1</FirstName>
    <IDNumber>sample string 3</IDNumber>
    <LastName>sample string 2</LastName>
  </Individual>
  <Organisation>
    <BusinessName>sample string 2</BusinessName>
    <RegistrationNumber>sample string 1</RegistrationNumber>
  </Organisation>
  <Signers>
    <Signer>
      <Capacity>sample string 3</Capacity>
      <Email>sample string 8</Email>
      <IdentityNo>sample string 6</IdentityNo>
      <MobileNumber>sample string 7</MobileNumber>
      <Name>sample string 5</Name>
      <OnBehalfOf>sample string 2</OnBehalfOf>
      <RSAResident>true</RSAResident>
      <SignerType>sample string 9</SignerType>
      <Surname>sample string 4</Surname>
    </Signer>
    <Signer>
      <Capacity>sample string 3</Capacity>
      <Email>sample string 8</Email>
      <IdentityNo>sample string 6</IdentityNo>
      <MobileNumber>sample string 7</MobileNumber>
      <Name>sample string 5</Name>
      <OnBehalfOf>sample string 2</OnBehalfOf>
      <RSAResident>true</RSAResident>
      <SignerType>sample string 9</SignerType>
      <Surname>sample string 4</Surname>
    </Signer>
  </Signers>
</IndemnityRequest>

application/x-www-form-urlencoded

Sample:

Failed to generate the sample for media type 'application/x-www-form-urlencoded'. Cannot use formatter 'JQueryMvcFormUrlEncodedFormatter' to write type 'IndemnityRequest'.

Response Information

Resource Description

ServiceResponse
NameDescriptionTypeAdditional information
Success

boolean

None.

Message

string

None.

TransactionId

string

None.

Response Formats

application/json, text/json

Sample:
{
  "Success": true,
  "Message": "sample string 2",
  "TransactionId": "sample string 3"
}

application/xml, text/xml

Sample:
<ServiceResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/MercantileEventHandler.ViewModels">
  <Message>sample string 2</Message>
  <Success>true</Success>
  <TransactionId>sample string 3</TransactionId>
</ServiceResponse>