|
IHS Markit API |
GET v1/Bonds/Identifier/{id}/{identifierValue}
Description
Retrieve a bond for an identifier type with WSO ID of {id} and value of {identifierValue}.
Base Url
https://services.wsoweb.com/
Rest Call Syntax
GET SecurityMaster/v1/Bonds/Identifier/{id}/{identifierValue}
GET SecurityMaster/v1/Bonds/Identifier/{id}/{identifierValue}
Limitations
There are no limitations specified.
Request Information
Parameters
Name
Description
Type
Additional Information
id
WSO ID of identifier type
integer
Required
identifierValue
Identifier value
string
Required
Response Information
Bond
Name
Description
Type
Additional Information
AssetClassId
The class of the asset by ID value
integer
BondName
The name of the asset in WSO which typically includes the coupon rate and maturity date
string
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
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
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
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
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
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
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
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
Response Body Formats
application/json, text/json
{
"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-11-23T01:53:34.5602383-06:00",
"defaultType": "sample string 7",
"firstCouponDate": "2024-11-23T01:53:34.5602383-06:00",
"firstSettleDate": "2024-11-23T01:53:34.5602383-06:00",
"fixedRate": 1.1,
"guarantorId": 1,
"hasAttachedWarrants": true,
"hasDefaulted": true,
"hasFXRisk": true,
"holidayCalendarId": 1,
"insurerId": 1,
"interestAccrualDate": "2024-11-23T01:53:34.5607674-06:00",
"isCallable": true,
"isEmergingMarket": true,
"isInterestOnly": true,
"isPIKBond": true,
"isBaseRateObservationShiftEnabled": true,
"isPrincipalOnly": true,
"isPrivate": true,
"isPutable": true,
"isRestructured": true,
"isStructuredFinanceObligation": true,
"issueDate": "2024-11-23T01:53:34.5607674-06: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-11-23T01:53:34.5607674-06:00",
"maturityDateExpected": "2024-11-23T01:53:34.5607674-06: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
<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-11-23T01:53:34.5602383-06:00</DefaultDate>
<DefaultType>sample string 7</DefaultType>
<FirstCouponDate>2024-11-23T01:53:34.5602383-06:00</FirstCouponDate>
<FirstSettleDate>2024-11-23T01:53:34.5602383-06: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-11-23T01:53:34.5607674-06: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-11-23T01:53:34.5607674-06: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-11-23T01:53:34.5607674-06:00</MaturityDate>
<MaturityDateExpected>2024-11-23T01:53:34.5607674-06: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>