Endpoints

Data formats

There are currently 3 data formats for response data:

  • JSON
  • XML
  • HTML

Format as HTTP header

To request the wished response data format, it ist possible to use the Accept header.

Format Accept-Header
JSON
Accept: application/json
XML
Accept: application/xml
HTML
Accept: text/html

Format as query parameter

As an alternativ it is possible to use a query param

Format Query param
JSON
http://api.hansainvest.com/api/v1/endpoint/?format=json
XML
http://api.hansainvest.com/api/v1/endpoint/?format=xml
HTML
http://api.hansainvest.com/api/v1/endpoint/?format=html

Basic fund data

All funds specific endpoints return some basic fund information for the chosen fund:

Field Type Description
fund Object List of alle fund data
  name String Fund name
  isin String International Securities Identification Number (ISIN)
  wkn String Wertpapierkennnummer (WKN) – german
  fund_inception_date Date (ISO) Fund inception date
  url String Link (URL) to fund details on hansainvest.com

See the following examples for data types JSON and XML.

Example return (JSON)

{
    "fund": {
        "name": "3ik-Strategiefonds I Class I",
        "isin": "DE000A1H44G8",
        "wkn": "A1H44G",
        "fund_inception_date": "2011-12-01",
        "url": "https://www.hansainvest.com/deutsch/fondswelt/fondsdetails.html?fondsid=151"
    }
}

Example return (XML)

<?xml version="1.0"?>
<root>
  <fund>
    <name>3ik-Strategiefonds I Class I</name>
    <isin>DE000A1H44G8</isin>
    <wkn>A1H44G</wkn>
    <fund_inception_date>2011-12-01</fund_inception_date>
    <url>https://www.hansainvest.com/deutsch/fondswelt/fondsdetails.html?fondsid=151</url>
  </fund>
</root>

Errors

Code Problem Description
400 No ISIN provided For the used endpoint it is necessary to provide the ISIN to identify the fund.
404 There is no fund with this ISIN: [ISIN] No fund can be found for the provided ISIN.
403 It is not permitted to get data for the fund with ISIN: [ISIN] For some reasons for the fund there is no data provided by the HI-API .

Error response (example)

{
    "title": "No ISIN provided",
    "type": "https://api.hansainvest.com/docs/v1/endpoints/index/#error-400-noisin",
    "status": 404
}