GET v1/Bonds/{id}

Description

Retrieve a bond with WSO ID of {id}.

Base Url

https://api-zion.wsohosting.com/


Rest Call Syntax


GET SecurityMaster/v1/Bonds/{id}

GET SecurityMaster/v1/Bonds/{id}

Verb

Base Url

URI parameters

 = 

Authentication



Response Format


Headers

Add header


 

Delete




Limitations

There are no limitations specified.




Request Information


Parameters

Name

Description

Type

Additional Information

id

WSO ID of bond

integer

Required




Response Information



Bond

Name

Description

Type

Additional Information

AssetClassId

The class of the asset by ID value

integer

BaseRateCompoundMethod

The CompoundMethod

BaseRateInterestMethod

The InterestMethod

BondName

The name of the asset in WSO which typically includes the coupon rate and maturity date

string

CallSchedule

The Hateoas link for call schedule

Collateral

The description of the collateral that is backing the asset

string

ConvertibleType

The entity into which the asset can be converted

string

CountryId

The legal country of this asset by ID value

integer

CouponDateOffset

Business Day Offset - this determines when a coupon should pay if the coupon date falls on a non-business day

CouponFrequency

The Coupon Frequency indicates how many times a year there is a coupon payment

CouponRates

The Hateoas link to get all coupon rate schedules for the asset

Coupons

The Hateoas link to get all coupon schedules for the asset

CouponType

The Coupon Type of the asset

CurrencyCode

The currency type of the asset

string

DateOffset

Given the type of coupon - this is the number of days to offset the coupon rate

integer

DayCount

The Day Count convention for the asset

DefaultDate

The date that the asset went into default

date

DefaultType

The type of default that has occurred

string

FirstCouponDate

The first date that the asset has a coupon payment

date

FirstSettleDate

The first settle date listed for the asset

date

FixedRate

The fixed coupon rate

decimal number

GuarantorId

The guarantor for the asset by ID value

integer

HasAttachedWarrants

The flag indicating if the asset has attached warrants

boolean

HasDefaulted

The flag indicating if the asset has defaulted

boolean

HasFXRisk

The flag indicating if the asset has foreign exchange risk

boolean

HolidayCalendarId

The holiday calendar for the asset by ID value

integer

Id

The WSO ID for the asset

integer

Identifiers

The Hateoas link to get all identifiers for the asset

InsurerId

The insurer of the asset by ID value

integer

InterestAccrualDate

The first date that the asset starts accruing interest

date

IsBaseRateObservationShiftEnabled

Gets or sets a flag indicating whether or not base rate observation shift is enabled for this Bond asset.

boolean

IsCallable

The flag indicating if the asset is callable

boolean

IsCollateralized

Determines if the bond is collateralized

boolean

IsDeleted

A flag indicating if the asset is soft-deleted in the system

boolean

IsEmergingMarket

The flag indicating if the asset is from an emerging market

boolean

IsInterestOnly

The flag indicating if this is an interest only asset

boolean

IsPIKBond

The flag indicating if the asset allows payments in kind (PIK)

boolean

IsPrincipalOnly

The flag indicating if this is a principal only asset

boolean

IsPrivate

The flag indicating if the asset is a private security

boolean

IsPutable

The flag to enable a Put Schedule

boolean

IsRestructured

The flag indicating if the security has been restructured since it was initially issued

boolean

IsStructuredFinanceObligation

The flag indicating if the asset belongs to a structured finance obligation

boolean

IssueDate

The date that the asset was officially issued

date

IssuePrice

The original price at which the asset was issued

decimal number

Issuer

A link to retrieve the Issuer

IssueSize

The global amount of the asset at issuance

decimal number

IsSynthetic

The flag indicating if this a synthetic security

boolean

IsTradedAccrued

The flag indicating if the asset trades with accrued interest

boolean

Links

The Hateoas links related to this entity

Collection of Link

LockoutDays

integer

MaturityDate

The maturity date of the asset

date

MaturityDateExpected

The expected maturity date of the asset - optional field

date

Notes

The notes regarding the asset

string

PayNonBusinessDirection

Pay Offset - if the coupon falls on a non-business day this field determines when the coupon will pay

PayOffsetDays

Pay Offset - the number of days that coupon payment occurs differing from the coupon date

integer

PayOffsetDirection

Pay Offset - the number of days for the payment offset

PayOffsetType

Pay Offset - the type of days to count: business or actual

PaysEndOfMonth

The flag indicating if this asset pays end of month when the first coupon date does not fall on the 31st

boolean

PIKCashPercentage

PIK - the cash percentage

decimal number

PIKPercentage

PIK - the PIK percentage

decimal number

Ratings

The Hateoas link to get all Link Ratings

RegistrationType

The registration type

string

SeniorityId

The seniority level of the asset by ID value

integer

SpreadRate

The spread rate of the asset

decimal number

Udfs

The Hateoas link to get all Udfs




Response Body Formats



application/json, text/json

Sample:
{
  "id": 1,
  "bondName": "sample string 2",
  "assetClassId": 1,
  "isCollateralized": true,
  "collateral": "sample string 4",
  "convertibleType": "sample string 5",
  "countryId": 1,
  "currencyCode": "sample string 6",
  "couponDateOffset": "None",
  "couponFrequency": "Annual",
  "couponType": "Fixed",
  "dateOffset": 1,
  "dayCount": "ACT_ACT",
  "defaultDate": "2024-10-08T05:34:00.7828751-05:00",
  "defaultType": "sample string 7",
  "firstCouponDate": "2024-10-08T05:34:00.7828751-05:00",
  "firstSettleDate": "2024-10-08T05:34:00.7828751-05:00",
  "fixedRate": 1.1,
  "guarantorId": 1,
  "hasAttachedWarrants": true,
  "hasDefaulted": true,
  "hasFXRisk": true,
  "holidayCalendarId": 1,
  "insurerId": 1,
  "interestAccrualDate": "2024-10-08T05:34:00.7828751-05:00",
  "isCallable": true,
  "isEmergingMarket": true,
  "isInterestOnly": true,
  "isPIKBond": true,
  "isBaseRateObservationShiftEnabled": true,
  "isPrincipalOnly": true,
  "isPrivate": true,
  "isPutable": true,
  "isRestructured": true,
  "isStructuredFinanceObligation": true,
  "issueDate": "2024-10-08T05:34:00.7828751-05:00",
  "issuePrice": 1.1,
  "issueSize": 1.0,
  "isSynthetic": true,
  "isTradedAccrued": true,
  "issuer": {
    "verb": "sample string 1",
    "rel": "sample string 2",
    "uri": "http://webapihelppage3.com"
  },
  "maturityDate": "2024-10-08T05:34:00.7828751-05:00",
  "maturityDateExpected": "2024-10-08T05:34:00.7828751-05:00",
  "notes": "sample string 26",
  "payNonBusinessDirection": "On",
  "payOffsetDays": 27,
  "payOffsetDirection": "After",
  "payOffsetType": "BusinessDays",
  "paysEndOfMonth": true,
  "pikCashPercentage": 1.1,
  "pikPercentage": 1.1,
  "registrationType": "sample string 29",
  "seniorityId": 1,
  "spreadRate": 1.1,
  "lockoutDays": 30,
  "isDeleted": true,
  "links": [
    {
      "verb": "sample string 1",
      "rel": "sample string 2",
      "uri": "http://webapihelppage3.com"
    },
    {
      "verb": "sample string 1",
      "rel": "sample string 2",
      "uri": "http://webapihelppage3.com"
    }
  ],
  "couponRates": {
    "verb": "sample string 1",
    "rel": "sample string 2",
    "uri": "http://webapihelppage3.com"
  },
  "callSchedule": {
    "verb": "sample string 1",
    "rel": "sample string 2",
    "uri": "http://webapihelppage3.com"
  },
  "coupons": {
    "verb": "sample string 1",
    "rel": "sample string 2",
    "uri": "http://webapihelppage3.com"
  },
  "identifiers": {
    "verb": "sample string 1",
    "rel": "sample string 2",
    "uri": "http://webapihelppage3.com"
  },
  "ratings": {
    "verb": "sample string 1",
    "rel": "sample string 2",
    "uri": "http://webapihelppage3.com"
  },
  "udfs": {
    "verb": "sample string 1",
    "rel": "sample string 2",
    "uri": "http://webapihelppage3.com"
  },
  "baseRateInterestMethod": "Unassigned",
  "baseRateCompoundMethod": "Unassigned"
}

application/xml, text/xml

Sample:
<Bond xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <AssetClassId>1</AssetClassId>
  <BaseRateCompoundMethod>Unassigned</BaseRateCompoundMethod>
  <BaseRateInterestMethod>Unassigned</BaseRateInterestMethod>
  <BondName>sample string 2</BondName>
  <CallSchedule>
    <Rel>sample string 2</Rel>
    <Uri>http://webapihelppage3.com/</Uri>
    <Verb>sample string 1</Verb>
  </CallSchedule>
  <Collateral>sample string 4</Collateral>
  <ConvertibleType>sample string 5</ConvertibleType>
  <CountryId>1</CountryId>
  <CouponDateOffset>None</CouponDateOffset>
  <CouponFrequency>Annual</CouponFrequency>
  <CouponRates>
    <Rel>sample string 2</Rel>
    <Uri>http://webapihelppage3.com/</Uri>
    <Verb>sample string 1</Verb>
  </CouponRates>
  <CouponType>Fixed</CouponType>
  <Coupons>
    <Rel>sample string 2</Rel>
    <Uri>http://webapihelppage3.com/</Uri>
    <Verb>sample string 1</Verb>
  </Coupons>
  <CurrencyCode>sample string 6</CurrencyCode>
  <DateOffset>1</DateOffset>
  <DayCount>ACT_ACT</DayCount>
  <DefaultDate>2024-10-08T05:34:00.7828751-05:00</DefaultDate>
  <DefaultType>sample string 7</DefaultType>
  <FirstCouponDate>2024-10-08T05:34:00.7828751-05:00</FirstCouponDate>
  <FirstSettleDate>2024-10-08T05:34:00.7828751-05:00</FirstSettleDate>
  <FixedRate>1.1</FixedRate>
  <GuarantorId>1</GuarantorId>
  <HasAttachedWarrants>true</HasAttachedWarrants>
  <HasDefaulted>true</HasDefaulted>
  <HasFXRisk>true</HasFXRisk>
  <HolidayCalendarId>1</HolidayCalendarId>
  <Id>1</Id>
  <Identifiers>
    <Rel>sample string 2</Rel>
    <Uri>http://webapihelppage3.com/</Uri>
    <Verb>sample string 1</Verb>
  </Identifiers>
  <InsurerId>1</InsurerId>
  <InterestAccrualDate>2024-10-08T05:34:00.7828751-05:00</InterestAccrualDate>
  <IsBaseRateObservationShiftEnabled>true</IsBaseRateObservationShiftEnabled>
  <IsCallable>true</IsCallable>
  <IsCollateralized>true</IsCollateralized>
  <IsDeleted>true</IsDeleted>
  <IsEmergingMarket>true</IsEmergingMarket>
  <IsInterestOnly>true</IsInterestOnly>
  <IsPIKBond>true</IsPIKBond>
  <IsPrincipalOnly>true</IsPrincipalOnly>
  <IsPrivate>true</IsPrivate>
  <IsPutable>true</IsPutable>
  <IsRestructured>true</IsRestructured>
  <IsStructuredFinanceObligation>true</IsStructuredFinanceObligation>
  <IsSynthetic>true</IsSynthetic>
  <IsTradedAccrued>true</IsTradedAccrued>
  <IssueDate>2024-10-08T05:34:00.7828751-05:00</IssueDate>
  <IssuePrice>1.1</IssuePrice>
  <IssueSize>1</IssueSize>
  <Issuer>
    <Rel>sample string 2</Rel>
    <Uri>http://webapihelppage3.com/</Uri>
    <Verb>sample string 1</Verb>
  </Issuer>
  <Links>
    <Link>
      <Rel>sample string 2</Rel>
      <Uri>http://webapihelppage3.com/</Uri>
      <Verb>sample string 1</Verb>
    </Link>
    <Link>
      <Rel>sample string 2</Rel>
      <Uri>http://webapihelppage3.com/</Uri>
      <Verb>sample string 1</Verb>
    </Link>
  </Links>
  <LockoutDays>30</LockoutDays>
  <MaturityDate>2024-10-08T05:34:00.7828751-05:00</MaturityDate>
  <MaturityDateExpected>2024-10-08T05:34:00.7828751-05:00</MaturityDateExpected>
  <Notes>sample string 26</Notes>
  <PIKCashPercentage>1.1</PIKCashPercentage>
  <PIKPercentage>1.1</PIKPercentage>
  <PayNonBusinessDirection>On</PayNonBusinessDirection>
  <PayOffsetDays>27</PayOffsetDays>
  <PayOffsetDirection>After</PayOffsetDirection>
  <PayOffsetType>BusinessDays</PayOffsetType>
  <PaysEndOfMonth>true</PaysEndOfMonth>
  <Ratings>
    <Rel>sample string 2</Rel>
    <Uri>http://webapihelppage3.com/</Uri>
    <Verb>sample string 1</Verb>
  </Ratings>
  <RegistrationType>sample string 29</RegistrationType>
  <SeniorityId>1</SeniorityId>
  <SpreadRate>1.1</SpreadRate>
  <Udfs>
    <Rel>sample string 2</Rel>
    <Uri>http://webapihelppage3.com/</Uri>
    <Verb>sample string 1</Verb>
  </Udfs>
</Bond>



Feedback



(0 out of 1500 characters used)
Feedback has been submitted. Thank you for your feedback.
Automatic feedback submission has been turned off by your system administrator. Your feedback has been logged to the exceptions table. Please contact support to find out how to manually send in your feedback. Thank you.