GET v1/Bonds/PointInTime

Retrieves data for an bond based on the instrument id, one or more series types, and a specific point in time. For a list of series types available, refer to the Series Types API.

Request Information

Parameters

Name Type Description Additional information
request BondGetPointInTimeRequest Container for the EntityGetPointInTimeBatchRequest input parameters. See parameter details below.

Define this parameter in the request URI.

Parameter Information

Parameter Name: request

Property Type Description
IdList String Comma-delimeted list of IDs. Can be the instrument id, CUSIP, or ISIN.
SeriesTypes String A comma-delimeted list of data points to retrieve for the specified entity id. Valid Series Types can be retrieved from the Series Type Service.
PointInTime DateTime The date for which you want to retrieve data.
SdkVersion String If the client is using the SDK, the version number will be passed along with the request. This field is optional.

Response Information

Response body formats

application/json, text/json

Sample:
{
  "dataPoints": [
    {
      "instrumentId": 1,
      "cusip": "sample string 2",
      "isin": "sample string 3",
      "seriesType": "sample string 4",
      "dataDate": "2026-06-05T14:55:47.0267645+00:00",
      "value": "sample string 6",
      "currency": "sample string 7",
      "scale": 8,
      "requiresSubscription": false
    },
    {
      "instrumentId": 1,
      "cusip": "sample string 2",
      "isin": "sample string 3",
      "seriesType": "sample string 4",
      "dataDate": "2026-06-05T14:55:47.0267645+00:00",
      "value": "sample string 6",
      "currency": "sample string 7",
      "scale": 8,
      "requiresSubscription": false
    },
    {
      "instrumentId": 1,
      "cusip": "sample string 2",
      "isin": "sample string 3",
      "seriesType": "sample string 4",
      "dataDate": "2026-06-05T14:55:47.0267645+00:00",
      "value": "sample string 6",
      "currency": "sample string 7",
      "scale": 8,
      "requiresSubscription": false
    }
  ],
  "errorOccurred": false,
  "errorMessages": [
    "sample string 1",
    "sample string 2",
    "sample string 3"
  ],
  "request": {
    "idList": "sample string 1",
    "seriesTypes": "sample string 2",
    "pointInTime": "2026-06-05T14:55:47.0267645+00:00",
    "sdkVersion": "sample string 4"
  }
}

application/xml, text/xml

Sample:
<BondGetPointInTimeResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <ErrorMessages xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>sample string 1</d2p1:string>
    <d2p1:string>sample string 2</d2p1:string>
    <d2p1:string>sample string 3</d2p1:string>
  </ErrorMessages>
  <ErrorOccurred>false</ErrorOccurred>
  <Request>
    <SdkVersion>sample string 4</SdkVersion>
    <IdList>sample string 1</IdList>
    <PointInTime>2026-06-05T14:55:47.0267645+00:00</PointInTime>
    <SeriesTypes>sample string 2</SeriesTypes>
  </Request>
  <DataPoints xmlns:d2p1="http://schemas.datacontract.org/2004/07/MA.CreditEdge.Web.Api.Contract.Models">
    <d2p1:BondPointInTimeDataPoint>
      <d2p1:Currency>sample string 7</d2p1:Currency>
      <d2p1:Cusip>sample string 2</d2p1:Cusip>
      <d2p1:DataDate>2026-06-05T14:55:47.0267645+00:00</d2p1:DataDate>
      <d2p1:InstrumentId>1</d2p1:InstrumentId>
      <d2p1:Isin>sample string 3</d2p1:Isin>
      <d2p1:RequiresSubscription>false</d2p1:RequiresSubscription>
      <d2p1:Scale>8</d2p1:Scale>
      <d2p1:SeriesType>sample string 4</d2p1:SeriesType>
      <d2p1:Value>sample string 6</d2p1:Value>
    </d2p1:BondPointInTimeDataPoint>
    <d2p1:BondPointInTimeDataPoint>
      <d2p1:Currency>sample string 7</d2p1:Currency>
      <d2p1:Cusip>sample string 2</d2p1:Cusip>
      <d2p1:DataDate>2026-06-05T14:55:47.0267645+00:00</d2p1:DataDate>
      <d2p1:InstrumentId>1</d2p1:InstrumentId>
      <d2p1:Isin>sample string 3</d2p1:Isin>
      <d2p1:RequiresSubscription>false</d2p1:RequiresSubscription>
      <d2p1:Scale>8</d2p1:Scale>
      <d2p1:SeriesType>sample string 4</d2p1:SeriesType>
      <d2p1:Value>sample string 6</d2p1:Value>
    </d2p1:BondPointInTimeDataPoint>
    <d2p1:BondPointInTimeDataPoint>
      <d2p1:Currency>sample string 7</d2p1:Currency>
      <d2p1:Cusip>sample string 2</d2p1:Cusip>
      <d2p1:DataDate>2026-06-05T14:55:47.0267645+00:00</d2p1:DataDate>
      <d2p1:InstrumentId>1</d2p1:InstrumentId>
      <d2p1:Isin>sample string 3</d2p1:Isin>
      <d2p1:RequiresSubscription>false</d2p1:RequiresSubscription>
      <d2p1:Scale>8</d2p1:Scale>
      <d2p1:SeriesType>sample string 4</d2p1:SeriesType>
      <d2p1:Value>sample string 6</d2p1:Value>
    </d2p1:BondPointInTimeDataPoint>
  </DataPoints>
</BondGetPointInTimeResponse>