POST v1/Entities/PointInTime

Retrieves data for one or more entities based on the PID, one or more series types, and a specific point in time. Accepts large lists of entities. For a list of series types available, refer to the Series Types API.

Request Information

Parameters

Name	Type	Description	Additional information
request	EntityGetPointInTimeRequest	Container for the EntityGetPointInTimeBatchRequest input parameters. See parameter details below.	Define this parameter in the request body.

Request body formats

application/json, text/json

Sample:

{
  "idList": "sample string 1",
  "seriesTypes": "sample string 2",
  "pointInTime": "2026-06-05T14:54:07.3286775+00:00",
  "currency": "sample string 4",
  "sdkVersion": "sample string 5"
}

application/xml, text/xml

Sample:

<EntityGetPointInTimeRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/MA.CreditEdge.Web.Api.Contract.Messages.Entities">
  <SdkVersion xmlns="">sample string 5</SdkVersion>
  <Currency>sample string 4</Currency>
  <IdList>sample string 1</IdList>
  <PointInTime>2026-06-05T14:54:07.3286775+00:00</PointInTime>
  <SeriesTypes>sample string 2</SeriesTypes>
</EntityGetPointInTimeRequest>

Parameter Information

Parameter Name: request

Property	Type	Description
IdList	String	Comma-delimeted list of PIDs.
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.
Currency	String	Optional currency. If omitted, the default currency for the entity will be used.
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": [
    {
      "id": "sample string 1",
      "seriesType": "sample string 2",
      "dataDate": "2026-06-05T14:54:07.3286775+00:00",
      "value": "sample string 4",
      "currency": "sample string 5",
      "scale": 6,
      "requiresSubscription": false
    },
    {
      "id": "sample string 1",
      "seriesType": "sample string 2",
      "dataDate": "2026-06-05T14:54:07.3286775+00:00",
      "value": "sample string 4",
      "currency": "sample string 5",
      "scale": 6,
      "requiresSubscription": false
    },
    {
      "id": "sample string 1",
      "seriesType": "sample string 2",
      "dataDate": "2026-06-05T14:54:07.3286775+00:00",
      "value": "sample string 4",
      "currency": "sample string 5",
      "scale": 6,
      "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:54:07.3286775+00:00",
    "currency": "sample string 4",
    "sdkVersion": "sample string 5"
  }
}

application/xml, text/xml

Sample:

<EntityGetPointInTimeResponse 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 xmlns:d2p1="http://schemas.datacontract.org/2004/07/MA.CreditEdge.Web.Api.Contract.Messages.Entities">
    <SdkVersion>sample string 5</SdkVersion>
    <d2p1:Currency>sample string 4</d2p1:Currency>
    <d2p1:IdList>sample string 1</d2p1:IdList>
    <d2p1:PointInTime>2026-06-05T14:54:07.3286775+00:00</d2p1:PointInTime>
    <d2p1:SeriesTypes>sample string 2</d2p1:SeriesTypes>
  </Request>
  <DataPoints>
    <PointInTimeDataPoint>
      <Currency>sample string 5</Currency>
      <DataDate>2026-06-05T14:54:07.3286775+00:00</DataDate>
      <Id>sample string 1</Id>
      <RequiresSubscription>false</RequiresSubscription>
      <Scale>6</Scale>
      <SeriesType>sample string 2</SeriesType>
      <Value>sample string 4</Value>
    </PointInTimeDataPoint>
    <PointInTimeDataPoint>
      <Currency>sample string 5</Currency>
      <DataDate>2026-06-05T14:54:07.3286775+00:00</DataDate>
      <Id>sample string 1</Id>
      <RequiresSubscription>false</RequiresSubscription>
      <Scale>6</Scale>
      <SeriesType>sample string 2</SeriesType>
      <Value>sample string 4</Value>
    </PointInTimeDataPoint>
    <PointInTimeDataPoint>
      <Currency>sample string 5</Currency>
      <DataDate>2026-06-05T14:54:07.3286775+00:00</DataDate>
      <Id>sample string 1</Id>
      <RequiresSubscription>false</RequiresSubscription>
      <Scale>6</Scale>
      <SeriesType>sample string 2</SeriesType>
      <Value>sample string 4</Value>
    </PointInTimeDataPoint>
  </DataPoints>
</EntityGetPointInTimeResponse>