Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Section
Column
Excerpt

The get portfolio request returns a portfolio from the CME CORE database by its identifier.

Table of Contents
maxLevel4

 




Column
width300px
Align
alignright
EntityPortfolio
ActionGet
URL/portfolios/{id}
HTTP MethodGET
Parameter InputYes
XML InputNo
Multiple OutputNo
SynchronousYes

Description

The request allows the Client to get or retrieve the contents of a portfolio which has been added to CME CORE (Add Portfolio and Update Portfolio). The client must submit the unique CME CORE-assigned portfolio identifier in the URL request. If no portfolio is found with the identifier, an error is returned. an error is also returned when the user is not authorized to delete the portfolio. If the portfolio is found, it is returned. Only portfolios are returned, does not include transactions or other data.   

Request

ParameterNameTypeRequiredNotes
reqUserIdRequesting User IDStringNo
 

Response

XPathNameTypeRequiredNotes
/portfolioRpt/error@codeError CodeStringNo
 

/portfolioRpt/error@msgError MessageStringNo
 

/portfolioRpt/portfolio@createTimeCreate TimeDate/TimeYes
 

/portfolioRpt/portfolio@descDescriptionStringNo
 

/portfolioRpt/portfolio@idPortfolio IDStringYes
 

/portfolioRpt/portfolio@nameNameString No
 

/portfolioRpt/portfolio@rptCcyReporting CurrencyString 
Yes
No
 

/portfolioRpt/portfolio@updateTimeUpdate TimeDate/Time Yes
 

/portfolioRpt/portfolio/entities@clrMbrFirmIdClearing Member Firm IDString Yes
 

/portfolioRpt/portfolio/entities@custAcctIdCustomer Account IDString Yes
 

Errors

CodeDescription
403Returned if the user does not have permission to access the specified portfolio.
404Returned if the requested portfolio could not be found.
500The server was not able to process the request. More information (if available) will be provided in the error message.

Examples

Valid

A portfolio with ID 12 exists in the CORE database.

...

Code Block
languagehtml/xml
linenumberstrue
<portfolioRpt<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:portfolioRpt xmlns:ns2="http://cmegroup.com/schema/core/1.2" status="ERROR">
    <error codemsg="404" message="No portfolio with this ID exists." Portfolio ID [1521306] was not found." code="404"/>
</ns2:portfolioRpt>